gw.transforms.waveform_transforms.DecimateWaveformsAndASDS

gw.transforms.waveform_transforms.DecimateWaveformsAndASDS(
    multibanded_frequency_domain,
    decimation_mode,
)

Transform operator for decimation of unwhitened waveforms and corresponding ASDS to multibanded frequency domain (MFD).

For decimation, we have two options.

decimation_mode = whitened In this case, the GW data is whitened first,
```
 dw = d / ASD,
```

and then decimated to the MFD,

    dw_mfd = decimate(dw).

In this case, the effective ASD in the MFD is given by

    ASD_mfd = 1 / decimate(1 / ASD).

See [1] for details. ASD_mfd can then be provided to the inference network.

decimation_mode = unwhitened In this case, the GW data is first decimated,
```
 d_mfd = decimate(d)
```

and then whitened.

    dw_mfd = d_mfd / ASD_mfd.

In this case, the ASD_mfd that whitens the data d_mfd is given by

    ASD_mfd = decimate(ASD ** 2) ** 0.5.

In other words, in this case we need to decimate the PSD. See [1] for details.

Method 1) better preserves the signal.

[1] https://github.com/dingo-gw/dingo/blob/fede5c01524f3e205acf5750c0a0f101ff17e331/binary_neutron_stars/prototyping/psd_decimation.ipynb

Parameters

Name	Type	Description	Default
multibanded_frequency_domain	MultibandedFrequencyDomain	New domain of the decimated data. Original data must be in multibanded_frequency_domain.base_domain	required
decimation_mode	str	One of [“whitened”, “unwhitened”]. Determines whether decimation is performed on whitened data or on unwhitened data. See class docstring for details.	required

Name	Description
decimation_mode
multibanded_frequency_domain