pyRing
is a python package for black hole (BH) ringdown analysis, model comparison and parameter estimation.
The package is tailored to the analysis of the post-merger phase of Compact Binary Coalescence (CBC) Gravitational-wave (GW) signals using a native time-domain likelihood formulation. It is integrated with standard LIGO-Virgo-Kagra software and supports:
Ringdown analyses of interferometric or simulated GW data using a variety of ringdown waveform models. All of them are analytical templates, some of them are calibrated to Numerical Relativity (NR).
Parametrised tests of General Relativity (GR), by adding parametrised deviations to the spectrum frequencies and damping times.
Quasi-normal modes (QNM) spectrum predictions for emissions alternative to the Kerr solution.
The main usage features of the software have been internally reviewed for scientific usage from the LIGO-Virgo-Kagra (LVK) collaboration and the code is routinely used to produce catalogs of BH ringdown properties and tests of GR in the merger-ringdown regime by the LVK collaboration.
The software can be accessed on git.ligo.org.
Disclaimer: since the name pyring
had already been taken on pypi (which is not case sensitive), the package has to be pip-installed or conda-installed with the name pyRingGW
. However, for all internal purposes and functionalities, the name of the package is pyRing
. For example, the help message can be accessed through pyRing --help
.
Tutorial slides (both on the physics and inference methods behind the analysis) are available here. See also below for brief instructions on how to run tutorial examples.