Pipeline

def inject_cbc_signal(  # noqa: PLR0913
    waveform_model: str,
    params: dict[str, Any],
    detector_names: Sequence[str | CustomDetector],
    background: Mapping[str, TimeSeries],
    *,
    sampling_frequency: float,
    minimum_frequency: float,
    waveform_backend: WaveformBackend | None = None,
    earth_rotation: bool = True,
    interpolate_if_offset: bool = True,
) -> DetectorStrainStack:
    """Inject a CBC signal into background strain for a network of detectors.

    Orchestrates waveform generation, detector projection, and strain injection
    for compact binary coalescence (CBC) sources. Returns a
    ``DetectorStrainStack`` containing the injected strain for each detector.

    Args:
        waveform_model: Time-domain approximant name (e.g. ``'IMRPhenomD'``).
        params: CBC injection parameters; must include ``detector_frame_mass_1``,
            ``detector_frame_mass_2``, ``coa_time``, ``distance``, ``inclination``,
            ``right_ascension``, ``declination``, and ``polarization_angle``.
        detector_names: IFO codes for the target network
            (e.g. ``['H1', 'L1', 'V1']``).
        background: Mapping of detector name to background ``TimeSeries``
            (e.g. noise or zeros segment).
        sampling_frequency: Sample rate in Hz.
        minimum_frequency: Low-frequency cutoff in Hz, passed to the waveform
            generator.
        waveform_backend: Optional waveform backend instance used to generate
            polarizations. Defaults to ``LALSimulationBackend`` via
            ``CBCSimulator``.
        earth_rotation: If ``True``, evaluate antenna patterns at
            time-dependent GPS times (recommended for longer signals). If
            ``False``, use a single reference time at the segment midpoint.
        interpolate_if_offset: If ``True``, use cubic interpolation when the
            injection start is not on a target sample boundary. If ``False``
            and the injection is off-grid, the background is returned
            unchanged (``target.copy()``) rather than resampled.

    Returns:
        ``DetectorStrainStack`` with one injected strain channel per detector in
        ``detector_names`` order.

    Raises:
        ValueError: If any required parameter key is missing from ``params``.
        ValueError: If a detector name is not recognized by the detector registry.
        KeyError: If a detector name is missing from ``background``.
    """
    return CBCSimulator(waveform_model=waveform_model, waveform_backend=waveform_backend).simulate(
        params,
        detector_names,
        background,
        sampling_frequency=sampling_frequency,
        minimum_frequency=minimum_frequency,
        earth_rotation=earth_rotation,
        interpolate_if_offset=interpolate_if_offset,
    )