API reference¶
This section documents the public Python API of gwmock-signal. Pages are
generated with mkdocstrings from Google-style docstrings in the source
tree (src/gwmock_signal/).
How to use this site
- For workflow overview and example snippets, use User guide → Examples (sidebar).
- For exact signatures, types, and raised exceptions, use the API sections below.
- For
gwmock-signalCLI flags and JSON formats, use User guide → Command-line interface.
Sections¶
| Section | Contents |
|---|---|
| Waveform | WaveformFactory, WaveformBackend, LALSimulationBackend, PyCBCBackend, pycbc_waveform_wrapper |
| Projection | project_polarizations_to_network |
| Injection | inject_strain, inject_strains_sequential |
| Pipeline | inject_cbc_signal (CBC orchestration) |
| Multichannel | DetectorStrainStack |
| Network | Network (presets, from_file, detector lists) |
| Simulator | GWSimulator, TransientSimulator, CBCSimulator, stable DetectorStrainStack return contract |
| Registry | resolve_simulator_backend, register_simulator_backend, list_registered_source_types |
| Utility | Logging and other helpers |
Main entry points (quick links)¶
- Waveform — Time-domain polarizations:
WaveformFactoryoverLALSimulationBackend(default) orPyCBCBackend(optional); directpycbc_waveform_wrapperfor PyCBC-only workflows. - Projection — Strain per detector
(
project_polarizations_to_network). - Injection — Strain into segments (
inject_strain,inject_strains_sequential). - Pipeline — One-call CBC injection (
inject_cbc_signal). - Multichannel — Stacked IFO strains
(
DetectorStrainStack). - Network — Named networks and YAML/JSON network configs.
- Simulator — Simulator base class, CBC implementation, and
the stable
DetectorStrainStackreturn contract. - Registry — Lookup
GWSimulatorsubclasses bysource_typestring (for examplebbh). - Utility — Utility functions.
Top-level package exports¶
import gwmock_signal re-exports the following symbols via
gwmock_signal.__init__. Prefer these imports in application code; submodule
paths are stable but longer.
| Symbol | Category | Reference |
|---|---|---|
CBCSimulator |
Simulator | Simulator API |
TransientSimulator |
Simulator | Simulator API |
GWSimulator |
Simulator | Simulator API |
DetectorStrainStack |
Multichannel | Multichannel API |
Network |
Network | Network API |
CustomDetector |
Detector | Network API |
WaveformBackend |
Waveform | Waveform API |
LALSimulationBackend |
Waveform | Waveform API |
resolve_simulator_backend |
Registry | Registry API |
register_simulator_backend |
Registry | Registry API |
list_registered_source_types |
Registry | Registry API |
__version__ |
Version | (string) |