pyRing supports most of the analytical ringdown models available in the literature:
Damped Sinusoids model
This is the simplest model available, consisting of a superposition of damped sinusoid . It supports up to all five polarisations (the ones independent in a L-shaped GW detector, see this reference) allowed for a metric theory of gravity, employing the conventions:
hs=∑jAsj⋅cos(ωsjt+ϕsj)⋅e−(t−t0j)/τsj,hvx−ihvy=∑jAvj⋅ei(ωvjt+ϕvj)⋅e−(t−t0j)/τvj,h+−ih×=∑jAtj⋅ei(ωtjt+ϕtj)⋅e−(t−t0j)/τtj.Where, for each mode, the complex amplitudes and complex frequencies Aj,ϕj,ωj,τj are left free to vary and t0j is the start time.
Kerr model
h++ih×=MfDL∞∑ℓ=2+ℓ∑m=−ℓ∞∑n=0(h+ℓmn+h−ℓmn)with:
h+ℓmn=A+ℓmnSℓmn(ι,φ)ei[(t−tℓmn)˜ωℓmn+ϕ+ℓmn]h−ℓmn=A−ℓmnSℓ−mn(ι,φ)e−i[(t−tℓmn)˜ω∗ℓmn−ϕ−ℓmn]where ˜ωℓmn=ωℓmn+i/τℓmn is the complex ringdown frequency (a * denotes complex conjugation), expressed as a function of the remnant BH mass Mf and spin af, ˜ωℓmn=˜ωℓmn(Mf,af). The amplitudes A+/−ℓmn and phases ϕ+/−ℓmn characterise the excitation of each mode. In the case where the progenitors binary has spins aligned with the orbital angular momentum, reflection symmetry implies (see e.g. Blanchet’s review): ˜A−=(−1)l⋅˜A+∗, halving the number of free parameters per mode (* denotes complex conjugation, and we grouped the A,ϕ parameters in a complex amplitude). The inclination of the BH final spin relative to the observer’s line of sight is denoted by ι, while φ corresponds to the azimuthal angle of the line of sight in the BH frame. Sℓmn are the spin-weighted spheroidal harmonics and tℓmn=t0 is a reference start time. In writing these equations, we follow the conventions of Lim et al. (see their Section III), accoding to which m>0 indices denote co-rotating modes, while counter-rotating modes are labeled by m<0. Counter-rotating modes are hardly excited in the post-merger phase for the binaries observed by LIGO-Virgo-Kagra. For a discussion about the possible relevance of counter-rotating modes see Refs. [1], [2]. For applications of this model to numerical relativity simulations, see e.g. 2110.03116, 2302.03050.
This model additionally supports:
Tail terms, see arxiv:2302.03050 and references therein.
Quadratic modes, see arxiv:2208.07374 and references therein.
Parametric deviations from GR QNM predictions:
Parametrised deviations to QNM frequencies and damping times as predicted by GR can be added in the form:
ωlmn=ωGRlmn⋅(1+δωlmn),τlmn=τGRlmn⋅(1+δτlmn).and extracted from the data. See the GWTC-2 testing GR catalog for additional details on the method.
QNM spectrum induced by the area quantisation:
The ringdown model from Foit and Kleban, assuming a modification of the ringdown spectrum induced by the area quantisation hypothesis is also implemented. The quantisation is parametrised by a new parameter α, determining the new QNM spectrum, labeled by an index N:
ωN=ωN(Mf,af,α),τN=τN(Mf,af,α).For details of the implementation, the application of the model to current observations and to simulated data, see this reference. A more realistic model of this scenario, considering the echoes generated from such a modification, was presented in this reference. For an extended discussion, see Agullo et al..
ParSpec deviations:
The software also supports perturbative deviations within the Parametrized ringdown spin expansion coefficients formalism, introduced in this reference. The formalism first considers a perturbative expansion of the QNM spectrum in powers of the remnant spin, adding deviation parameters at each given order in spin, in the form:
ωK=1MNmax∑j=0χjω(j)K(1+γδω(j)K),τK=MNmax∑j=0χjτ(j)K(1+γδτ(j)K).where each mode is labeled by K, ω(j)K,τ(j)K are the GR spin-expansion coefficients and δω(j)K are the beyond-GR coefficients, to be inferred from the data. The beyond GR coupling is controlled by the parameter:
γ=α(1+z)pMpfexpressed as a function of a theory-dependent coupling α, with p representing its mass dimension.
Such a formalism encompasses large classes of modified theories of gravity. Depending on the theory considered, in certain cases it allowed to place the most stringent constraints to date on some of these alternative theories. Details of the implementation and the application to observational data were presented here.
Eistein-scalar-Gauss-Bonnet corrections:
Coming soon…
Kerr-Newman charges:
Coming soon…
Note: at the moment, for the Kerr multipolar model, the modes are supposed to start all at the same time. This implicitly assumes that all the modes are already excited when the analysis is start.
Multi-modal ringdown non-spinning (MMRDNS) model
This model, introduced in this reference is an improvement of the Kerr model in the case where the remnant black hole is generated by the quasi-circular coalescence of two non-spinning progenitor black holes. It models the most dominant modes (up to ℓ=5) for the parameter space considered, assumes the conjugate symmetry discussed above and does not keep into account counter-rotating modes. The amplitudes and phases are tuned to BBH numerical simulations and are expressed as a function of the progenitors parameters:
Almn=Almn(η),ϕlmn=ϕlmn(η).where η is the symmetric mass ratio of the progenitors binary. The model describes only the late ringdown and was calibrated at 10Mf after the peak of ψNR22. For low-SNR events it can be extrapolated to earlier times, but its accuracy should be explicitly checked. See also this reference for a discussion of the start time and an application of the model to ringdown parameter estimation.
Multi-modal ringdown non-precessing (MMRDNP) model
This model, introduced in this reference, is an improvement to MMRDNS to the case of spinning, non-precessing, progenitors. It employs a spherical decomposition, keeping into account mode mixing between different spheroidal modes. It models the most dominant modes (up to ℓ=4) for the parameter space considered, assumes the conjugate symmetry discussed above and does not keep into account counter-rotating modes. The complex amplitudes are now expressed as:
Alm=Alm(η,χs,χa),ϕlm=ϕlm(η,χs,χa).where η is the symmetric mass ratio of the progenitors binary, χs is a symmetric spin combination of the progenitors binary, and χa is a anti-symmetric spin combination of the progenitors binary. The model describes only the late ringdown and was calibrated at 20Mf after the peak of h22. For low-SNR events it can be extrapolated to earlier times, but its accuracy should be explicitly checked.
Kamaretsos-Hannam-Husa-Sathyaprakash (KHS) multi-modal model
This model, introduced in [1] and [2] is similar to MMRDNP, but uses a different fit of the amplitudes. Phases have not been tuned to numerical relativity and are set to zero by default. It models the most dominant modes (up to ℓ=4) for the parameter space considered, assumes the conjugate symmetry discussed above and does not keep into account counter-rotating modes.
Tidal Effective One Body post-merger (TEOBPM) model
The TEOBPM model, introduced in Damour and Nagar, arXiv:1406.0401, accurately describes the whole post-merger phase (from the peak of h22 onwards) for spinning, non-precessing binaries. The amplitudes and phases are calibrated to full numerical simulation, and the waveform is constructed through a spherical decomposition of the most dominant modes (up to ℓ=5) with a resummation strategy keeping into account nonlinearities and overtones contributions through a phenomenological description of time-dependent amplitudes.
Alm=Alm(t;m1,m2χ1,χ2),ϕlm=ϕlm(t;m1,m2,χ1,χ2).Since the model starts at the peak of the emission, in this case also the time-delays between the peak of the different modes are crucially kept into account. Further details on the model can be found in references [1] and [2].
This model also forms the basis for the ringdown of IMRPhenomTPHM, arXiv:2105.05872. An implementation of the model in C is available here. A systematic characterisation of the model, and its application to higher-modes searches on GWTC-3 data can be found in Gennari et al., arXiv:2312.12515.
A script showing how to handle all available models can be found in pyring/scripts/Waveform_utils/plot_waveform.py
.