Skip to content

User guide

gwmock-signal provides small, composable building blocks for time-domain GW signal simulation in Python, aligned with PyCBC, GWpy, and typical LIGO/Virgo/KAGRA analysis habits. The parent gwmock package (separate repo) is intended to orchestrate full mock-data challenges; this library focuses on the physics-adjacent primitives.

Typical pipeline

flowchart LR
    W[Waveforms] --> P[Projection]
    P --> I[Injection]
    I --> M[Multichannel]

Under User guide → Examples in the sidebar:

  1. Waveforms — Produce \(h_{+}\), \(h_{\times}\) with PyCBC; optional registry for custom models.
  2. Detector projection — Map polarizations to each IFO strain using antenna patterns and delays.
  3. Strain injection — Add simulated strain into a longer GWpy segment (e.g. zeros or noise).
  4. Multichannel strains — Stack per-detector series in a fixed order for array-oriented code.

Example pages are narrative + copy-paste snippets. Authoritative API details (signatures, types, exceptions) are only in API (auto-generated from docstrings):

Topic Examples (this site) Reference (signatures & types)
Waveforms Waveforms Waveform API
Projection Detector projection Projection API
Injection Strain injection Injection API
Multichannel Multichannel strains Multichannel API

Prerequisites

See also