Skip to content

IMRPhenomXAS NRTidalv3

ripplegw.waveforms.IMRPhenomXAS_NRTidalv3 ¤

by Robin Chan

_gen_IMRPhenomXAS_NRTidalv3(f: Array, f_ref: float, theta_intrinsic: Array, theta_extrinsic: Array, bbh_amp: Array, bbh_psi: Array, no_taper: bool = False) ¤

Master internal function to get the GW strain for given parameters.

The function takes a BBH strain, computed from an underlying BBH approximant, e.g. IMRPhenomD, and applies the tidal corrections to it afterwards.

Parameters:

Name Type Description Default
f Array

Frequencies in Hz.

 required
f_ref float

Reference frequency for the waveform.

 required
theta_intrinsic Array

Intrinsic parameters of the system: [m1, m2, chi1, chi2, lambda1, lambda2].

 required
theta_extrinsic Array

Extrinsic parameters of the system: [d_L, tc, phi_c].

 required
bbh_amp Array

The BBH amplitude of the underlying model (before applying tidal corrections).

 required
bbh_psi Array

The BBH phase of the underlying model (before applying tidal corrections).

 required
no_taper bool

Whether to disable tapering. Default is False.

 False

Returns:

Name Type Description
Array

Final complex-valued strain of GW.

gen_IMRPhenomXAS_NRTidalv3(f: Array, params: Array, f_ref: float, use_lambda_tildes: bool = True, no_taper: bool = False) -> Array ¤

Generate NRTidalv3 frequency domain waveform following 2311.07456.

Parameters:

Name Type Description Default
f Array

Frequencies in Hz.

 required
params Array

Array containing both intrinsic and extrinsic variables: theta = [Mchirp, eta, chi1, chi2, lambda1, lambda2, D, tc, phic]:

  • Mchirp: Chirp mass of the system [solar masses]
  • eta: Symmetric mass ratio [between 0.0 and 0.25]
  • chi1: Dimensionless aligned spin of the primary object [between -1 and 1]
  • chi2: Dimensionless aligned spin of the secondary object [between -1 and 1]
  • lambda1: Dimensionless tidal deformability of primary object
  • lambda2: Dimensionless tidal deformability of secondary object
  • D: Luminosity distance to source [Mpc]
  • tc: Time of coalescence. This only appears as an overall linear in f contribution to the phase
  • phic: Phase of coalescence
 required
f_ref float

Reference frequency for the waveform.

 required
use_lambda_tildes bool

Use lambda tilde and delta lambda instead of lambda1 and lambda2. Default is True.

 True
no_taper bool

Whether to disable tapering. Default is False.

 False

Returns:

Name Type Description
h0 Array

Strain.

gen_IMRPhenomXAS_NRTidalv3_hphc(f: Array, params: Array, f_ref: float, use_lambda_tildes: bool = True, no_taper: bool = False) ¤

Generate NRTidalv3 frequency domain waveform with plus and cross polarizations.

IMRPhenom denotes the name of the underlying BBH approximant used, before applying tidal corrections.

Parameters:

Name Type Description Default
f Array

Frequencies in Hz.

 required
params Array

Array containing both intrinsic and extrinsic variables: theta = [Mchirp, eta, chi1, chi2, lambda1, lambda2, D, tc, phic, inclination]:

  • Mchirp: Chirp mass of the system [solar masses]
  • eta: Symmetric mass ratio [between 0.0 and 0.25]
  • chi1: Dimensionless aligned spin of the primary object [between -1 and 1]
  • chi2: Dimensionless aligned spin of the secondary object [between -1 and 1]
  • lambda1: Dimensionless tidal deformability of primary object
  • lambda2: Dimensionless tidal deformability of secondary object
  • D: Luminosity distance to source [Mpc]
  • tc: Time of coalescence. This only appears as an overall linear in f contribution to the phase
  • phic: Phase of coalescence
  • inclination: Inclination angle of the binary [between 0 and PI]
 required
f_ref float

Reference frequency for the waveform.

 required
use_lambda_tildes bool

Use lambda tilde and delta lambda instead of lambda1 and lambda2. Default is True.

 True
no_taper bool

Whether to disable tapering. Default is False.

 False

Returns:

Name Type Description
hp Array

Strain of the plus polarization.
hc Array

Strain of the cross polarization.