Skip to content

Conversions

ripplegw.conversions ¤

Parameter conversion utilities for binary systems.

Includes conversions between mass parameterisations and tidal parameters.

Mc_eta_to_ms(m: Array) -> tuple[Array, Array] ¤

Convert chirp mass and symmetric mass ratio to binary component masses.

Parameters:

Name Type Description Default
m Array

Array (Mchirp, eta) — chirp mass and symmetric mass ratio.

 required

Returns:

Type Description
tuple[Array, Array]

tuple[Array, Array]: Component masses :math:(m_1, m_2) in the same units as the chirp mass, with :math:m_1 \geq m_2.

ms_to_Mc_eta(m: Array) -> tuple[Array, Array] ¤

Convert binary component masses to chirp mass and symmetric mass ratio.

Parameters:

Name Type Description Default
m Array

Array (m1, m2) — component masses.

 required

Returns:

Type Description
tuple[Array, Array]

tuple[Array, Array]: :math:(\mathcal{M}, \eta), with the chirp mass in the same units as the component masses.

_compute_lambda_tildes_from_eta(eta: Array, lambda_1: Array, lambda_2: Array) -> tuple[Array, Array] ¤

Core tidal conversion: individual lambdas → (lambda_tilde, delta_lambda_tilde) given eta.

_compute_lambdas_from_eta(eta: Array, lambda_tilde: Array, delta_lambda_tilde: Array) -> tuple[Array, Array] ¤

Core tidal conversion: (lambda_tilde, delta_lambda_tilde) → individual lambdas given eta.

lambdas_to_lambda_tildes(params: Array) -> tuple[Array, Array] ¤

Convert from individual tidal parameters to dominant tidal terms. (Code taken from Bilby)

See, e.g., Wade et al., https://arxiv.org/pdf/1402.5156.pdf.

Parameters:

Name Type Description Default
params Array

(lambda_1, lambda_2, mass_1, mass_2)

 required

Returns:

Type Description
tuple[Array, Array]

(lambda_tilde, delta_lambda_tilde)

lambdas_to_lambda_tildes_from_q(params: Array) -> tuple[Array, Array] ¤

Convert from individual tidal parameters to dominant tidal terms using mass ratio. (Code taken from Bilby)

See, e.g., Wade et al., https://arxiv.org/pdf/1402.5156.pdf.

Parameters:

Name Type Description Default
params Array

(lambda_1, lambda_2, q)

 required

Returns:

Type Description
tuple[Array, Array]

(lambda_tilde, delta_lambda_tilde)

lambda_tildes_to_lambdas(params: Array) -> tuple[Array, Array] ¤

Convert from dominant tidal terms to individual tidal parameters. Code taken from bilby.

See, e.g., Wade et al., https://arxiv.org/pdf/1402.5156.pdf.

Parameters:

Name Type Description Default
params Array

(lambda_tilde, delta_lambda_tilde, mass_1, mass_2)

 required

Returns:

Type Description
tuple[Array, Array]

(lambda_1, lambda_2)

lambda_tildes_to_lambdas_from_q(params: Array) -> tuple[Array, Array] ¤

Convert from dominant tidal terms to individual tidal parameters using mass ratio. Code taken from bilby.

See, e.g., Wade et al., https://arxiv.org/pdf/1402.5156.pdf.

Parameters:

Name Type Description Default
params Array

(lambda_tilde, delta_lambda_tilde, q)

 required

Returns:

Type Description
tuple[Array, Array]

(lambda_1, lambda_2)