Simulates detector noise.

Synopsis

lalsim-detector-noise [options]

Description

The lalsim-detector-noise utility produces a continuous stream of simulated detector noise for a specified interval of time and for a specified noise PSD. Alternatively, lalsim-detector-noise outputs a requested noise PSD. The output is written to the standard output in two-column ascii format data in which the first column contains either the GPS times of each sample or the frequency of each PSD component, and the second column contains the value of that sample.

Options

-h, --help: print this message and exit
--verbose: verbose output
-0, --0noise: no noise (generates zeros)
-A, --aligo-nosrm: aLIGO no SRM noise
-B, --aligo-zerodet-lowpower: aLIGO zero detuning low power noise
-C, --aligo-zerodet-highpower: aLIGO zero detuning high power noise
-D, --aligo-nsnsopt: aLIGO NSNS optimized noise
-E, --aligo-bhbh20deg: aLIGO BHBH optimized 20 deg detuning noise
-F, --aligo-highfreq: aLIGO kHz narrowband noise
-I, --iligo-srd: iLIGO SRD noise power
-v, --virgo: initial Virgo noise power
-V, --advvirgo: Advanced Virgo noise power
-g, --geo: GEO600 noise power
-G, --geohf: GEO-HF noise power
-T, --tama: TAMA300 noise power
-K, --kagra: KAGRA noise power
-O, --official: use official data files
-P, --psd-only: output PSD only (actually ASD)
-a, --asd-file ASDFILE: read amplitude spectrum density file
-s, --start-time GPSSTART: GPS start time (s)
-t, --duration DURATION: (required) duration of data to produce (s)
-r, --sample-rate SRATE: sample rate (Hz) [16384]
-d, --segment-duration SEGDUR: segment duration (s) [4]
-f, --low-frequency FLOW: override default low frequency (Hz)

Environment

The LAL_DEBUG_LEVEL can used to control the error and warning reporting of lalsim-detector-noise. 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.

Exit Status

The lalsim-detector-noise utility exits 0 on success, and >0 if an error occurs.

Example

The command:

lalsim-detector-noise --aligo-zerodet-highpower -s 1000000000 -t 1000

will stream 1000 seconds of aLIGO zero detuning high power noise beginning at GPS time 1000000000.

The command:

lalsim-detector-noise --iligo-srd -P

outputs the Initial LIGO PSD.

The command:

lalsim-detector-noise -0 -s 1000000000 -t 1000

will stream 1000 seconds of zero-noise beginning at GPS time 1000000000.