LALSimulation  5.4.0.1-fe68b98
LALSimBlackHoleRingdownPrec.h File Reference

Prototypes

INT4 XLALSimIMREOBFinalMassSpinPrec (REAL8 *finalMass, REAL8 *finalSpin, const REAL8 mass1, const REAL8 mass2, const REAL8 spin1[3], const REAL8 spin2[3], Approximant approximant)
 Computes the final mass and spin of the black hole resulting from merger. More...
 
INT4 XLALSimIMREOBGenerateQNMFreqV2Prec (COMPLEX16Vector *modefreqs, const REAL8 mass1, const REAL8 mass2, const REAL8 spin1[3], const REAL8 spin2[3], UINT4 l, INT4 m, UINT4 nmodes, Approximant approximant)
 This function generates the quasinormal mode frequencies for a black hole ringdown. More...
 
INT4 XLALSimIMREOBGenerateQNMFreqV2FromFinalPrec (COMPLEX16Vector *modefreqs, const REAL8 mass1, const REAL8 mass2, const REAL8 finalMass, const REAL8 finalSpin, UINT4 l, INT4 m, UINT4 nmodes)
 This function generates the quasinormal mode frequencies for a black hole ringdown. More...
 

Go to the source code of this file.

Function Documentation

◆ XLALSimIMREOBFinalMassSpinPrec()

INT4 XLALSimIMREOBFinalMassSpinPrec ( REAL8 finalMass,
REAL8 finalSpin,
const REAL8  mass1,
const REAL8  mass2,
const REAL8  spin1[3],
const REAL8  spin2[3],
Approximant  approximant 
)

Computes the final mass and spin of the black hole resulting from merger.

They are given by fittings of NR simulations results. Specifically, for EOBNR, Table I of Buonanno et al. PRD76, 104049; for EOBNRv2 and EOBNRv2HM, Eqs. 29a and 29b of Pan et al. PRD84, 124052; for SEOBNRv1, Eq. 8 of Tichy and Marronetti PRD78, 081501 and Eqs. 1 and 3 of Barausse and Rezzolla ApJ704, L40.

They are given by fittings of NR simulations results. Specifically, for EOBNR, Table I of Buonanno et al. PRD76, 104049; for EOBNRv2 and EOBNRv2HM, Eqs. 29a and 29b of Pan et al. PRD84, 124052; for SEOBNRv1, SEOBNRv2, Eq. 8 of Tichy and Marronetti PRD78, 081501 and Eqs. 1 and 3 of Barausse and Rezzolla ApJ704, L40. Complemented by https://dcc.ligo.org/T1400476. For SEOBNRv4P: i) the final mass comes from Eq(3) in https://dcc.ligo.org/T1400476, but we use q<=1; ii) the final spin comes from Eq(13-16) for Hofmann et al, https://iopscience.iop.org/article/10.3847/2041-8205/825/2/L19/meta [arxiv:1605.01938]

Parameters
finalMass< OUTPUT, the final mass (scaled by original total mass)
finalSpin< OUTPUT, the final spin (scaled by final mass)
mass1< The mass of the 1st component of the system
mass2< The mass of the 2nd component of the system
spin1< The spin of the 1st object; only needed for spin waveforms
spin2< The spin of the 2nd object; only needed for spin waveforms
approximant< The waveform approximant being used

Definition at line 39 of file LALSimBlackHoleRingdownPrec.c.

◆ XLALSimIMREOBGenerateQNMFreqV2Prec()

INT4 XLALSimIMREOBGenerateQNMFreqV2Prec ( COMPLEX16Vector modefreqs,
const REAL8  mass1,
const REAL8  mass2,
const REAL8  spin1[3],
const REAL8  spin2[3],
UINT4  l,
INT4  m,
UINT4  nmodes,
Approximant  approximant 
)

This function generates the quasinormal mode frequencies for a black hole ringdown.

At present, this function works for the 22, 21, 33, 44 and 55 modes, and includes 8 overtones. The final frequencies are computed by interpolating the data found on the webpage of Vitor Cardoso, http://centra.ist.utl.pt/~vitor/?page=ringdown In this page, frequecy data are given for positive final spins only. For a negative final spin chi<0 case, the (l,m) mode frequency is given by the (l,-m) mode frequency of the positive final spin -chi case.

Parameters
modefreqs< OUTPUT, complex freqs of overtones in unit of Hz
mass1< The mass of the 1st component (in Solar masses)
mass2< The mass of the 2nd component (in Solar masses)
spin1< The spin of the 1st object; only needed for spin waveforms
spin2< The spin of the 2nd object; only needed for spin waveforms
l< The l value of the mode in question
m< The m value of the mode in question
nmodes< The number of overtones that should be included (max 8)
approximant< The waveform approximant being used

Definition at line 329 of file LALSimBlackHoleRingdownPrec.c.

◆ XLALSimIMREOBGenerateQNMFreqV2FromFinalPrec()

INT4 XLALSimIMREOBGenerateQNMFreqV2FromFinalPrec ( COMPLEX16Vector modefreqs,
const REAL8  mass1,
const REAL8  mass2,
const REAL8  finalMass,
REAL8  finalSpin,
UINT4  l,
INT4  m,
UINT4  nmodes 
)

This function generates the quasinormal mode frequencies for a black hole ringdown.

At present, this function works for the 22, 21, 33, 44 and 55 modes, and includes 8 overtones. The final frequencies are computed by interpolating the data found on the webpage of Vitor Cardoso, http://centra.ist.utl.pt/~vitor/?page=ringdown In this page, frequecy data are given for positive final spins only. For a negative final spin chi<0 case, the (l,m) mode frequency is given by the (l,-m) mode frequency of the positive final spin -chi case.

Parameters
modefreqs< OUTPUT, complex freqs of overtones in unit of Hz
mass1< The mass of the 1st component (in Solar masses)
mass2< The mass of the 2nd component (in Solar masses)
finalMass< The mass of the final BH (scaled by original total mass)
finalSpin< The dimensionless spin of the final BH
l< The l value of the mode in question
m< The m value of the mode in question
nmodes< The number of overtones that should be included (max 8)

Definition at line 1926 of file LALSimBlackHoleRingdownPrec.c.