LALInference  4.1.6.1-b72065a
Header LALInferenceTemplate.h

Detailed Description

Main header file for LALInference signal template generating functions.

All template functions have a parameter

Parameters
[in,out]IFOdataused for both specifiying the signal parameter values and returning the waveform template.

Signal parameter values are passed to the template generating functions via the IFOdata->modelParams parameter.

Signal templates are either in time domain or frequency domain, and subsequent functions (e.g. for likelihood computation) may then act accordingly by checking the IFOdata->modelDomain parameter.

The actual template waveforms then are stored in the IFOdata->freqModelhPlus / IFOdata->freqModelhCross or IFOdata->timeModelhPlus / IFOdata->timeModelhCross slots. The template's amplitude is (for physical models) scaled to 1 Mpc luminosity distance.

Prototypes

void LALInferenceDumptemplateFreqDomain (LALInferenceVariables *currentParams, LALInferenceModel *model, const char *filename)
 De-bugging function writing a (frequency-domain) signal template to a CSV file. More...
 
void LALInferenceDumptemplateTimeDomain (LALInferenceVariables *currentParams, LALInferenceModel *model, const char *filename)
 De-bugging function writing a (time-domain) signal template to a CSV file. More...
 
void LALInferenceTemplateNullFreqdomain (LALInferenceModel *model)
 Returns a frequency-domain 'null' template (all zeroes, implying no signal present). More...
 
void LALInferenceTemplateNullTimedomain (LALInferenceModel *model)
 Returns a time-domain 'null' template (all zeroes, implying no signal present). More...
 
void LALInferenceTemplateSineGaussian (LALInferenceModel *model)
 Sine-Gaussian (burst) template. More...
 
void LALInferenceROQWrapperForXLALSimInspiralChooseFDWaveformSequence (LALInferenceModel *model)
 
void LALInferenceTemplateDampedSinusoid (LALInferenceModel *model)
 Damped Sinusoid template. More...
 
void LALInferenceTemplateSinc (LALInferenceModel *model)
 Sinc function (burst) template. More...
 
void LALInferenceTemplateASinOmegaT (LALInferenceModel *model)
 Trivial h(t) = A*sin(Omega*t) template. More...
 
void LALInferenceTemplateXLALSimInspiralChooseWaveform (LALInferenceModel *model)
 "XLALSimInspiralChooseWaveform{TD,FD}" wrapper. More...
 
void LALInferenceTemplateXLALSimBurstChooseWaveform (LALInferenceModel *model)
 
void LALInferenceTemplateXLALSimInspiralChooseWaveformPhaseInterpolated (LALInferenceModel *model)
 
void LALInferenceTemplateXLALSimBurstSineGaussianF (LALInferenceModel *model)
 

Function Documentation

◆ LALInferenceDumptemplateFreqDomain()

void LALInferenceDumptemplateFreqDomain ( LALInferenceVariables currentParams,
LALInferenceModel model,
const char filename 
)

De-bugging function writing a (frequency-domain) signal template to a CSV file.

File contains real & imaginary parts of plus & cross components. Template amplitude is (usually) scaled to 1 Mpc luminosity distance.

Definition at line 2287 of file LALInferenceTemplate.c.

◆ LALInferenceDumptemplateTimeDomain()

void LALInferenceDumptemplateTimeDomain ( LALInferenceVariables currentParams,
LALInferenceModel model,
const char filename 
)

De-bugging function writing a (time-domain) signal template to a CSV file.

File contains time series of plus & cross components. Template amplitude is (usually) scaled to 1 Mpc luminosity distance.

Definition at line 2322 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateNullFreqdomain()

void LALInferenceTemplateNullFreqdomain ( LALInferenceModel model)

Returns a frequency-domain 'null' template (all zeroes, implying no signal present).

Definition at line 165 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateNullTimedomain()

void LALInferenceTemplateNullTimedomain ( LALInferenceModel model)

Returns a time-domain 'null' template (all zeroes, implying no signal present).

Definition at line 186 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateSineGaussian()

void LALInferenceTemplateSineGaussian ( LALInferenceModel model)

Sine-Gaussian (burst) template.

The (plus-) waveform is given by:

\[ s(t) = a \times \exp(-((t - \mu) / \sigma)^2) \times \sin(2 \pi f (t-\mu) - \phi) \]

Note that by setting f=0, phi=pi/2 you get a "plain" Gaussian template.

Signal is (by now?) linearly polarised, i.e., the cross-component remains zero.

Required ( IFOdata->modelParams ) parameters are:

  • "time" (REAL8, the \( \mu \) parameter of the Gaussian part, in GPS seconds)
  • "sigma" (REAL8, width, the \( \sigma \) parameter of the Gaussian part, seconds)
  • "frequency" (REAL8, frequency \( f \) of the sine part, Hertz)
  • "phase" (REAL8, phase \( \phi \) (at time \( \mu \)), radians)
  • "amplitude" (REAL8, amplitude \( a \))

Definition at line 491 of file LALInferenceTemplate.c.

◆ LALInferenceROQWrapperForXLALSimInspiralChooseFDWaveformSequence()

void LALInferenceROQWrapperForXLALSimInspiralChooseFDWaveformSequence ( LALInferenceModel model)

Definition at line 234 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateDampedSinusoid()

void LALInferenceTemplateDampedSinusoid ( LALInferenceModel model)

Damped Sinusoid template.

The (plus-) waveform is an exponentially decaying sine wave:

\[ s(t) = a \times \exp((t-time) / \tau) \times sin(2 \pi f (t-time)) \]

where "time" is the time parameter denoting the instant at which the signal starts.

Signal is (by now?) linearly polarised, i.e., the cross-component remains zero.

Required ( IFOdata->modelParams ) parameters are:

  • "time" (REAL8, the instant at which the signal starts, in GPS seconds)
  • "tau" (REAL8, width parameter \( \tau \), seconds)
  • "frequency" (REAL8, frequency \( f \) of the sine part, Hertz)
  • "amplitude" (REAL8, amplitude \( a \))

Definition at line 540 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateSinc()

void LALInferenceTemplateSinc ( LALInferenceModel model)

Sinc function (burst) template.

The (plus-) waveform is a sinc function of given frequency:

\[ s(t) = a \times sinc(2 \pi f (t-time)) = a \times \sin(2 \pi f (t-time)) / (2 \pi f (t-time)) \]

where "time" is the time parameter denoting the signal's central peak location.

Signal is (by now?) linearly polarised, i.e., the cross-component remains zero.

Required ( IFOdata->modelParams ) parameters are:

  • "time" (REAL8, the instant at which the signal peaks, in GPS seconds)
  • "frequency" (REAL8, frequency \( f \) of the sine part, Hertz)
  • "amplitude" (REAL8, amplitude \( a \))

Definition at line 586 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateASinOmegaT()

void LALInferenceTemplateASinOmegaT ( LALInferenceModel model)

Trivial h(t) = A*sin(Omega*t) template.

Required ( IFOdata->modelParams ) parameters are:

  • "A" (REAL8, dimensionless amplitude)
  • "Omega" (REAL8, frequency, radians/sec)

Definition at line 625 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateXLALSimInspiralChooseWaveform()

void LALInferenceTemplateXLALSimInspiralChooseWaveform ( LALInferenceModel model)

"XLALSimInspiralChooseWaveform{TD,FD}" wrapper.

Required ( IFOdata->modelParams ) parameters are:

  • "m1" (REAL8, mass of object 1, solar masses)
  • "m2" (REAL8, mass of object 1, solar masses)
  • "inclination" (REAL8, inclination angle, radians)
  • "coa_phase" (REAL8, phase angle, radians)
  • "spin1x" (REAL8, x component of the spin of object 1)
  • "spin1y" (REAL8, y component of the spin of object 1)
  • "spin1z" (REAL8, z component of the spin of object 1)
  • "spin2x" (REAL8, x component of the spin of object 2)
  • "spin2y" (REAL8, y component of the spin of object 2)
  • "spin2z" (REAL8, z component of the spin of object 2)
  • "shift0" (REAL8, shift offset, radians)
  • "time" (REAL8, coalescence time, or equivalent/analog/similar, GPS seconds)
  • "PNorder" (REAL8, Phase PN order)
  • "

THIS IMPLEMENTATION IS NOT THREAD SAFE !!! (previous inclination value is stored as a static)

< +-polarization waveform [returned]

< x-polarization waveform [returned]

Definition at line 648 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateXLALSimBurstChooseWaveform()

void LALInferenceTemplateXLALSimBurstChooseWaveform ( LALInferenceModel model)

< +-polarization waveform [returned]

< x-polarization waveform [returned]

Definition at line 1891 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateXLALSimInspiralChooseWaveformPhaseInterpolated()

void LALInferenceTemplateXLALSimInspiralChooseWaveformPhaseInterpolated ( LALInferenceModel model)

< +-polarization waveform [returned]

< x-polarization waveform [returned]

Definition at line 1357 of file LALInferenceTemplate.c.

◆ LALInferenceTemplateXLALSimBurstSineGaussianF()

void LALInferenceTemplateXLALSimBurstSineGaussianF ( LALInferenceModel model)

< +-polarization waveform [returned]

< x-polarization waveform [returned]

Definition at line 2181 of file LALInferenceTemplate.c.