Simulates a generic burst gravitational waveformS.
lalsim-burst [options]
The lalsim-burst
utility produces a stream of a simulated gravitational waveform for a generic burst. The output data is the gravitational waveform polarizations in the time domain. The output is written to standard output as a three-column ascii format. The first column gives the time corresponding to each sample and the remaining columns give the gravitational waveform values for the two polarizations.
[default values in brackets]
-h
, --help
-v
, --verbose
-w
WAVEFM, --waveform=WAVEFM
-t
DT, --duration=DT
-f
FREQ, --frequency=FREQ
-b
BW, --bandwidth=BW
-q
Q, --quality-factor=Q
-e
ECC, --eccentricity=ECC
-p
PHI, --phase=PHI
-A
AMP, --amplitude=AMP
-H
HRSS, --hrss=HRSS
-F
FLUENCE, --fluence=
FLUENCE -R
SRATE, –sample-rate=SRATE The LAL_DEBUG_LEVEL
can used to control the error and warning reporting of lalsim-burst
. Common values are: LAL_DEBUG_LEVEL=0
which suppresses error messages, LAL_DEBUG_LEVEL=1
which prints error messages alone, LAL_DEBUG_LEVEL=3
which prints both error messages and warning messages, and LAL_DEBUG_LEVEL=7
which additionally prints informational messages.
The GSL_RNG_SEED
and GSL_RNG_TYPE
environment variables can be used to set the random number generator seed and type respectively when generating band-limited white-noise bursts.
The lalsim-burst
utility exits 0 on success, and >0 if an error occurs.
The command:
lalsim-burst --waveform BLTWNB --duration 0.1 --frequency 100 --bandwidth 100 --fluence 1e-14
produces a three-column ascii output to standard output; the rows are samples (at the default rate of 16384 Hz), and the three columns are 1. the time of each sample, 2. the plus-polarization strain, and 3. the cross-polarization strain. The waveform produced is a band-limited white-noise burst with equal power in its two polarizations (eccentricity=0, which is the default value), a duration of 0.1 seconds, a frequency of 100 Hz, a bandwidth of 100 Hz, and a fluence of \( 10^{-14}\, M_\odot c^2 / {\rm pc}^2 = 0.01\, M_\odot c^2 / {\rm Mpc}^2 \simeq 1.9\, {\rm J} / {\rm m}^2 \).
The command:
lalsim-burst -w SineGaussian -q 9 -e 1 -p 90 -f 150 -H 1e-22
produces a Q=9 linearly polarized (since the eccentricity is set to 1) sine-Gaussian (not a cosine-Gaussian since the phase is set to 90 degrees) centered at 150 Hz having root-sum-squared strain \( h_{\mathrm{rss}} = 10^{-22}\, {\rm Hz}^{-1/2} \).