Installation

This documentation describes how to perform parameter estimation of CBC triggers using RIFT. It is designed to be used by LVK members who have access to the LIGO DataGrid, which provides computing clusters and detector data to analyze. You can find more information on the LDG wiki page.

Before you begin, login to your cluster of choice (options here) as usual using your albert.einstein username.

Basic Installation from release

There are a couple ways to install RIFT from the standard release. Note that if you plan to work on development for RIFT, it is recommended that you follow the setup instructions below using a virtual environment and installation from the source.

Creating an environment

A python virtual environment an be very helpful to ensure that the correct version of RIFT is being used when you are performing your analyses. Creating an environment where everything can be installed is straightforward.

Installing RIFT

Once you have a working environment, you can do a basic RIFT install with the command

$ pip install --upgrade RIFT

Install RIFT for development

However, some users may want to install RIFT for development, allowing them to add features and test them. In the following, we demonstrate how to install a development version of RIFT on a LIGO Data Grid (LDG) cluster.

First, clone the repository

$ git clone git@git.ligo.org:rapidpe-rift/rift.git
$ cd RIFT/

Note

If you receive an error message:

git@git.ligo.org: Permission denied (publickey,gssapi-keyex,gssapi-with-mic).
fatal: Could not read from remote repository.

Then this indicates you have not correctly authenticated with your git.ligo account. It is recommended to resolve the authentication issue, but you can alternatively use the HTTPS URL: replace the first line above with

$ git clone https://git.ligo.org/rapidpe-rift/rift.git

Once you have cloned the repository, you need to install the software.

$ python setup.py install --user

This method is helpful if you need to edit the source. This method also ensures all the necessary dependencies are installed.

Environment Variables

Once you are logged in, you will need to set environment variables. We recommend you put these into a script you run before commencing an analysis.

cat > setup_RIFT.sh
export LIGO_USER_NAME=albert.einstein
export LIGO_ACCOUNTING=ligo.sim.o4.cbc.pe.rift
export PATH=${PATH}: # your path to RIFT here
export CUDA_DIR=/usr/local/cuda  # only needed for GPU code
export PATH=${PATH}:${CUDA_DIR}/bin  # only needed for GPU code

Dependencies

RIFT handles data from the interferometers directly using lal library.

RIFT uses several libraries to provide waveforms, including lalsimulation.

Additional environment variables are needed if you want to use waveforms through a non-lalsimulation interface. Such waveforms may include the python implementation of surrogate waveforms, NR waveforms, or the C++ implementation of TEOBResumS.