Skip to content

Conversions

Parameter conversion utilities for binary systems.

Includes conversions between mass parameterisations and tidal parameters.

Functions:

Name Description
Mc_eta_to_ms

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

lambda_tildes_to_lambdas

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

lambda_tildes_to_lambdas_from_q

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

lambdas_to_lambda_tildes

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

lambdas_to_lambda_tildes_from_q

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

ms_to_Mc_eta

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

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

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[FloatScalar, FloatScalar]

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

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

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 Float[Array, 4]

(lambda_tilde, delta_lambda_tilde, mass_1, mass_2)

required

Returns:

Type Description
tuple[FloatScalar, FloatScalar]

(lambda_1, lambda_2)

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

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 Float[Array, 3]

(lambda_tilde, delta_lambda_tilde, q)

required

Returns:

Type Description
tuple[FloatScalar, FloatScalar]

(lambda_1, lambda_2)

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

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 Float[Array, 4]

(lambda_1, lambda_2, mass_1, mass_2)

required

Returns:

Type Description
tuple[FloatScalar, FloatScalar]

(lambda_tilde, delta_lambda_tilde)

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

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 Float[Array, 3]

(lambda_1, lambda_2, q)

required

Returns:

Type Description
tuple[FloatScalar, FloatScalar]

(lambda_tilde, delta_lambda_tilde)

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

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[FloatScalar, FloatScalar]

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