Module LALSimBHNSRemnantFits.c

Detailed Description

Provides routines for NSBH remnant fits.

Author

Andrew Matas, Jonathan Thompson, Edward Fauchon-Jones, Sebastian Khan

This module provides an implementation of the NSBH remnant fits described by [18] and the underlying BBH remnant fits described by [11]. For a standalone python implementation please see https://git.tpi.uni-jena.de/core/bhnsremnant.

NSBH remnant routines
REAL8	XLALBHNS_mass_aligned (const REAL8 m1, const REAL8 m2, const REAL8 chi1, const REAL8 lam)
	Compute final black hole mass for aligned black hole spin. More...
REAL8	XLALBHNS_spin_aligned (const REAL8 m1, const REAL8 m2, const REAL8 chi1, const REAL8 lam)
	Compute final black hole spin for aligned black hole spin. More...
static REAL8	model3a (const REAL8 nu, const REAL8 ai, const REAL8 lam, const REAL8 *par)
	Template 3D model for an NSBH remnant property. More...
static void	pijk_to_pk (REAL8 *p, const REAL8 nu, const REAL8 ai, const REAL8 *par)
	Calculate parameters for 1D model. More...
static double	model1a (const REAL8 x, const REAL8 *p)
	Template 1D model for an NSBH remnant property. More...

BBH remnant routines
REAL8	XLALbbh_final_mass_non_precessing_UIB2016 (const REAL8 m1, const REAL8 m2, const REAL8 chi1, const REAL8 chi2)
	Calculate the final mass with the aligned-spin NR fit. More...
REAL8	XLALbbh_final_spin_non_precessing_UIB2016 (const REAL8 m1, const REAL8 m2, const REAL8 chi1, const REAL8 chi2)
	Calculate the final spin with the aligned-spin NR fit. More...

Function Documentation

XLALBHNS_mass_aligned()

REAL8 XLALBHNS_mass_aligned	(	const REAL8	m1,
		const REAL8	m2,
		const REAL8	chi1,
		const REAL8	lam
	)

Compute final black hole mass for aligned black hole spin.

See Table I (p7) in https://arxiv.org/abs/1903.11622 for the definition of the coefficients of this model.

Parameters

m1	Mass of BH (companion 1) (solar masses)
m2	Mass of NS (companion 2) (solar masses)
chi1	Dimensionless spin of BH (companion 1)
lam	Dimensionless tidal deformability of NS (companion 2)

Definition at line 35 of file LALSimBHNSRemnantFits.c.

XLALBHNS_spin_aligned()

REAL8 XLALBHNS_spin_aligned	(	const REAL8	m1,
		const REAL8	m2,
		const REAL8	chi1,
		const REAL8	lam
	)

Compute final black hole spin for aligned black hole spin.

See Table I (p7) in https://arxiv.org/abs/1903.11622 for the definition of the coefficients of this model.

Parameters

m1	Mass of BH (companion 1) (solar masses)
m2	Mass of NS (companion 2) (solar masses)
chi1	Dimensionless spin of BH (companion 1)
lam	Dimensionless tidal deformability of NS (companion 2)

Definition at line 66 of file LALSimBHNSRemnantFits.c.

model3a()

static REAL8 model3a ( const REAL8  nu, const REAL8  ai, const REAL8  lam, const REAL8 *  par  )

static

Template 3D model for an NSBH remnant property.

See Eq. (4) (p7) in https://arxiv.org/abs/1903.11622 for the definition of this function.

Parameters

nu	Symmetric mass ratio
ai	Dimensionless spin of BH (companion 1)
lam	Dimensionless tidal deformability of NS (companion 2)
par	Best fit parameters for particular instance of remnant fit

Definition at line 98 of file LALSimBHNSRemnantFits.c.

pijk_to_pk()

static void pijk_to_pk ( REAL8 *  p, const REAL8  nu, const REAL8  ai, const REAL8 *  par  )

static

Calculate parameters for 1D model.

See Eq. (5,6) (p7) in https://arxiv.org/abs/1903.11622 for the definition of this function.

Parameters

p	Output: Coefficients for 1D model
nu	Symmetric mass ratio
ai	Dimensionless spin of BH (companion 1)
par	Best fit parameters for particular instance of remnant fit

Definition at line 115 of file LALSimBHNSRemnantFits.c.

model1a()

static double model1a ( const REAL8  x, const REAL8 *  p  )

static

Template 1D model for an NSBH remnant property.

See Eq. (4) (p7) in https://arxiv.org/abs/1903.11622 for the definition of this function.

Parameters

x	Input parameter for 1D model
p	Coefficients for 1D model

Definition at line 152 of file LALSimBHNSRemnantFits.c.

XLALbbh_final_mass_non_precessing_UIB2016()

REAL8 XLALbbh_final_mass_non_precessing_UIB2016	(	const REAL8	m1,
		const REAL8	m2,
		const REAL8	chi1,
		const REAL8	chi2
	)

Calculate the final mass with the aligned-spin NR fit.

Calculate the final mass with the aligned-spin NR fit by Xisco Jimenez Forteza, David Keitel, Sascha Husa et al. [LIGO-P1600270] [https://arxiv.org/abs/1611.00332] versions v1 and v2 use the same ansatz, with v2 calibrated to additional SXS and RIT data

Parameters

m1	component mass of first BH (solar masses)
m2	component mass of second BH (solar masses)
chi1	dimensionless spin of first BH
chi2	dimensionless spin of second BH

Definition at line 174 of file LALSimBHNSRemnantFits.c.

XLALbbh_final_spin_non_precessing_UIB2016()

REAL8 XLALbbh_final_spin_non_precessing_UIB2016	(	const REAL8	m1,
		const REAL8	m2,
		const REAL8	chi1,
		const REAL8	chi2
	)

Calculate the final spin with the aligned-spin NR fit.

Calculate the final spin with the aligned-spin NR fit by Xisco Jimenez Forteza, David Keitel, Sascha Husa et al. [LIGO-P1600270] [https://arxiv.org/abs/1611.00332] versions v1 and v2 use the same ansatz, with v2 calibrated to additional SXS and RIT data

Parameters

m1	component mass of first BH (solar masses)
m2	component mass of second BH (solar masses)
chi1	dimensionless spin of first BH
chi2	dimensionless spin of second BH

Definition at line 262 of file LALSimBHNSRemnantFits.c.