sage.core.detectors

Detector-geometry helpers.

Thin wrappers over pycbc.detector for quantities that depend only on the detector network (independent of source/sky position), e.g. the light-travel time between a pair of detectors. Used by the multi-detector consistency head to bound the physically-allowed inter-detector arrival-time difference.

Functions

light_travel_time(det_a, det_b)	Exact light-travel time (seconds) between two detectors.
pairwise_light_travel_times(detectors)	Symmetric (D, D) matrix of pairwise light-travel times (seconds).

Module Contents

light_travel_time(det_a, det_b)

Exact light-travel time (seconds) between two detectors.

This is the maximum possible difference in signal arrival time between the two sites (a source on the line joining them), taken from pycbc’s LAL-backed detector geometry.

Parameters:

• det_a (str) – Detector names, e.g. "H1", "L1", "V1".

• det_b (str) – Detector names, e.g. "H1", "L1", "V1".

Returns:

Light-travel time in seconds (0.0 if det_a == det_b).

Return type:

float

pairwise_light_travel_times(detectors)

Symmetric (D, D) matrix of pairwise light-travel times (seconds).

Entry [i, j] is the light-travel time between detectors[i] and detectors[j]; the diagonal is zero. For the common two-detector network the single relevant value is [0, 1].

Parameters:

detectors (sequence of str) – Detector names in network order (typically cfg.detectors).

Return type:

np.ndarray, shape (D, D), float64