Injections with Customized Waveform Generation

⭐ Intermediate · ~20 min · Prerequisites: Performing Multi-Injection

PycWB injection configurations can use waveform parameters directly, parameters returned by a Python function, or a custom waveform generator. The useful examples to start from are:

Example	Use case
examples/sine_gaussian_injection	Burst waveform injections using burst-waveform.
examples/white_noise_burst_injection	White-noise-burst injections on real data.
examples/pyseobnr_injection	Custom waveform module and Python parameter generator.

Custom generators are configured with the injection.generator section:

injection:
  parameters_from_python:
    file: "generate_parameters.py"
    function: "get_injection_parameters"
  generator:
    module: "waveform_model/waveform.py"
    function: "get_td_waveform"

The generator function should return detector-frame waveform data compatible with the injection reader used by the configured waveform module. When injecting into real data, fetch the required GWOSC files first:

pycwb gwosc-data user_parameters.yaml
pycwb run user_parameters.yaml

---

You have learned

• ✅ How to use built-in waveform types: burst-waveform, white-noise-burst

• ✅ How to configure custom waveform generators from Python modules

• ✅ How to fetch GWOSC data for real-data injection runs

• ✅ When to use parameter-from-Python vs. static parameter lists

Next: Batch Injection Runs — submit injection campaigns to a cluster