Installing from pip:
$ pip install pyRingGW
Installing the source code:
~/.bashrcadd:$ export PYRING_PREFIX=/home/installation_directory/pyring
installation_directoryis the directory where you will be placing the
pyRingsource code. This path is needed for advanced functionalities such as QNM interpolation or injection of NR data.$ git clone firstname.lastname@example.org:cbc-testinggr/pyring.git $ cd pyring $ git lfs install $ git lfs pull $ pip install -r requirements.txt $ python setup.py install
--userto the last command in case you don’t have administrator’s permissions (for example if you are installing on a cluster). Alternatives to the last command are
python -m pip install .or
pip install .
Running the code:
The one-liner you are searching for is:$ pyRing --config-file config.ini
config_filesdirectory contains a variety of example files to analyse GW detections and injections (both ringdown templates and IMR injections). There is one example file for each waveform model supported, included all modifications to the Kerr hypothesis. The configuration files directory can either be found on the source code repository or under the path
installation_path/pyRing/config_files. To discover your
installation_path, type on the terminal:$ import pyRing $ pyRing.__file__
that will output the path under which the package was built.
A very fast example, to get you up to speed, can be launched by:$ pyRing --config-file installation_path/pyRing/config_files/Quickstart_configs/quick_gw150914_DS.ini
This allows the beginner to obtain a quick and rough measurement of GW150914 ringdown spectrum in under 3 minutes on a laptop (using aggressive priors and very light sampler settings). Other similar examples are available inside the Quickstart_configs directory. These examples are mainly meant to give beginners a sense of the output of the code for various models.
A fast analysis, with settings more reliable than the above, can be obtained by launching:$ pyRing --config-file repopath/pyRing/config_files/config_gw150914_local_data.ini
This run still uses a simplified noise estimation and simplified sampler settings, but allows to obtain a decent measurement in ~20 minutes.
Instead, a proper configuration file for the same run using production settings (hence obtaining publication-level results) can be launched by:$ pyRing --config-file repopath/pyRing/config_files/config_gw150914_production.ini
Never forget that the sampler settings may need adjustment based on the problem you want to tackle. See the Usage section for further discussion.
The software supports a variety of analysis and injection options, all of which can be explored by running:$ pyRing --help
The software is guaranteed to be compatible with