Main header file for LALInference signal template generating functions.
All template functions have a parameter
[in,out] | IFOdata | used 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.
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.
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.
void LALInferenceTemplateNullFreqdomain | ( | LALInferenceModel * | model | ) |
Returns a frequency-domain 'null' template (all zeroes, implying no signal present).
Definition at line 165 of file LALInferenceTemplate.c.
void LALInferenceTemplateNullTimedomain | ( | LALInferenceModel * | model | ) |
Returns a time-domain 'null' template (all zeroes, implying no signal present).
Definition at line 186 of file LALInferenceTemplate.c.
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.
void LALInferenceROQWrapperForXLALSimInspiralChooseFDWaveformSequence | ( | LALInferenceModel * | model | ) |
Definition at line 234 of file LALInferenceTemplate.c.
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.
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.
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.
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.
void LALInferenceTemplateXLALSimBurstChooseWaveform | ( | LALInferenceModel * | model | ) |
< +-polarization waveform [returned]
< x-polarization waveform [returned]
Definition at line 1891 of file LALInferenceTemplate.c.
void LALInferenceTemplateXLALSimInspiralChooseWaveformPhaseInterpolated | ( | LALInferenceModel * | model | ) |
< +-polarization waveform [returned]
< x-polarization waveform [returned]
Definition at line 1357 of file LALInferenceTemplate.c.
void LALInferenceTemplateXLALSimBurstSineGaussianF | ( | LALInferenceModel * | model | ) |
< +-polarization waveform [returned]
< x-polarization waveform [returned]
Definition at line 2181 of file LALInferenceTemplate.c.