Module rangeutils

Calculate the sensitivity distance to an inspiral with the given masses, for the given signal-to-noise ratio. See the following reference for information on the integral performed:

https://dcc.ligo.org/cgi-bin/private/DocDB/ShowDocument?docid=27267

Parameters:

• f (numpy.array) - frequency array
• S (numpy.array) - power spectral density array
• snr (float) - signal-to-noise ratio at which to calculate range
• m1 (float) - mass (in solar masses) of first binary component, default: 1.4
• m2 (float) - mass (in solar masses) of second binary component, default: 1.4
• fmin (float) - minimum frequency limit of integral, default: 10 Hz
• fmax (float) - maximum frequency limit of integral, default: ISCO
• horizon (bool) - return horizon distance in stead of angle-averaged, default: False

Returns: float

sensitive distance to an inspiral (in solar masses) for the given PSD and parameters

Calculate squeezing factor based on observed noise in given band and predicted shot noise

Parameters:

• f (numpy.array) - frequency array
• S (numpy.array) - power spectral density array
• dc (float)
• opgain (float)
• cavpf (float)
• fmin (float) - minimum frequency limit of integral, default: 1000 Hz
• fmax (float) - maximum frequency limit of integral, default: 2000 Hz

Returns: float

squeezing ratio in dB

Calculate the sensitive distance to a GW burst with the given intrinsic energy for the given signal-to-noise ratio snr, as a function of f.

Parameters:

• f (float or numpy.array) - frequency of interest
• S (numpy.array) - power spectral density
• snr (float) - signal-to-noise ratio of burst
• E (float) - instrinsic energy of burst, default: grb-like 0.01

Returns: float

sensitive distance in pc at which a GW burst with the given energy would be detected with the given SNR, as a function of it's frequency

Calculate the sensitive distance to a GW burst with the given intrinsic energy for the given signal-to-noise ratio snr, integrated over frequency.

Parameters:

• f (float or numpy.array) - frequency of interest
• S (numpy.array) - power spectral density
• snr (float) - signal-to-noise ratio of burst, default: 8
• E (float) - instrinsic energy of burst, default: grb-like 0.01
• fmin (float) - minimum frequency limit of integral, default: 10 Hz
• fmax (float) - maximum frequency limit of integral, default: ISCO

Returns: float

sensitive distance at which a GW burst with the given energy would be detected with the given SNR, integrated over frequency.