LALSimulation  5.4.0.1-fe68b98
LALSimNRSurRemnantUtils.h File Reference

Utils for NR surrogates for remnant BH mass, spin and recoil kick. More...

Prototypes

void NRSurRemnant_LoadH5File (LALH5File **file, const char *NRSurRemnant_DATAFILE)
 Loads H5 file for a NRSurRemnant model. More...
 
int NRSurRemnant_LoadScalarFit (ScalarFitData **fit_data, LALH5File *file, const char *grp_name)
 Loads a single NRSurRemnant GPR fit, as described in the supplementary materials of arxiv:1809.09125. More...
 
int NRSurRemnant_LoadVectorFit (VectorFitData **vector_data, UINT4 vec_dim, LALH5File *file, const char *grp_name)
 Loads a vector of NRSurRemnant GPR fits. More...
 
int PrecessingNRSurRemnant_Init (PrecessingRemnantFitData *sur_data, LALH5File *file)
 Initializes fit data for a precessing NRSurRemnant. More...
 
int AlignedSpinNRSurRemnant_Init (AlignedSpinRemnantFitData *sur_data, LALH5File *file)
 Initializes fit data for an aligned-spin NRSurRemnant. More...
 

Detailed Description

Utils for NR surrogates for remnant BH mass, spin and recoil kick.

Author
Vijay Varma

Definition in file LALSimNRSurRemnantUtils.h.

Go to the source code of this file.

Data Structures

struct  VectorFitData
 Data used in a single vector fit NOTE: basisFunctionOrders, coefs, componentIndices, and n_coefs are only used by NRSur7dq2. More...
 
struct  PrecessingRemnantFitData
 NRSurRemnant GPR fit data for the mass, spin, and recoil kick for generically precessing BBHs. More...
 
struct  AlignedSpinRemnantFitData
 NRSurRemnant GPR fit data for the mass, spin, and recoil kick for aligned-spin BBHs. More...
 

Macros

#define print_warning(...)
 
#define ScalarFitData   NRHybSurFitData
 

Macro Definition Documentation

◆ print_warning

#define print_warning (   ...)
Value:
if (lalDebugLevel & LALERRORBIT) \
printf("Warning - %s (%s:%d): ", __func__, __FILE__, __LINE__); \
printf(__VA_ARGS__);
LALERRORBIT

Definition at line 38 of file LALSimNRSurRemnantUtils.h.

◆ ScalarFitData

#define ScalarFitData   NRHybSurFitData

Definition at line 49 of file LALSimNRSurRemnantUtils.h.

Function Documentation

◆ NRSurRemnant_LoadH5File()

void NRSurRemnant_LoadH5File ( LALH5File **  file,
const char NRSurRemnant_DATAFILE 
)

Loads H5 file for a NRSurRemnant model.

Parameters
fileOutput: Returns the opened H5 file.
NRSurRemnant_DATAFILEH5 file name to load.

Definition at line 65 of file LALSimNRSurRemnantUtils.c.

◆ NRSurRemnant_LoadScalarFit()

int NRSurRemnant_LoadScalarFit ( ScalarFitData **  fit_data,
LALH5File file,
const char grp_name 
)

Loads a single NRSurRemnant GPR fit, as described in the supplementary materials of arxiv:1809.09125.

Parameters
fit_dataOutput: Fit data. *fit_data should be NULL. Space will be allocated.
fileOpened H5 file.
grp_nameH5 group name.

Definition at line 97 of file LALSimNRSurRemnantUtils.c.

◆ NRSurRemnant_LoadVectorFit()

int NRSurRemnant_LoadVectorFit ( VectorFitData **  vector_data,
UINT4  vec_dim,
LALH5File file,
const char grp_name 
)

Loads a vector of NRSurRemnant GPR fits.

Parameters
vector_dataOutput: Vector of fit data. *vector_data should be NULL. Space will be allocated.
vec_dimLength of the vector
fileOpened H5 file.
grp_nameH5 group name.

Definition at line 198 of file LALSimNRSurRemnantUtils.c.

◆ PrecessingNRSurRemnant_Init()

int PrecessingNRSurRemnant_Init ( PrecessingRemnantFitData sur_data,
LALH5File file 
)

Initializes fit data for a precessing NRSurRemnant.

The data includes a ScalarFitData for the final mass, and a VectorFitData for the final spin and kick 3-vectors.

Parameters
sur_dataOutput: Loaded surrogate data.
fileOpened H5 file.

Definition at line 239 of file LALSimNRSurRemnantUtils.c.

◆ AlignedSpinNRSurRemnant_Init()

int AlignedSpinNRSurRemnant_Init ( AlignedSpinRemnantFitData sur_data,
LALH5File file 
)

Initializes fit data for an aligned-spin NRSurRemnant.

The data includes a ScalarFitData for the final mass, z-component of the final spin, and x and y components of the recoil kick. The other components of the spin and kick are zero due to the symmetries of aligned-spin systems and are not modelled by the surrogate.

Parameters
sur_dataOutput: Loaded surrogate data.
fileOpened H5 file.

Definition at line 295 of file LALSimNRSurRemnantUtils.c.