torchsig.transforms.functional.passband_ripple

torchsig.transforms.functional.passband_ripple(data: ndarray, num_taps: int = 2, max_ripple_db: float = 2.0, coefficient_decay_rate: float = 1, rng: Generator | None = None) → ndarray[source]

Functional for passband ripple transforms.

This function applies a passband ripple effect to the input data by designing a filter with specified ripple characteristics and applying it to the data.

Parameters:

  • data – Complex valued IQ data samples.

  • num_taps – Number of taps in simulated filter. Defaults to 2.

  • max_ripple_db – Maximum allowed ripple in the simulated filter (in dB). Defaults to 2.0.

  • coefficient_decay_rate – The decay rate of the exponential weighting in the filter. Defaults to 1.0.

  • rng – Random number generator. Defaults to np.random.default_rng(seed=None).

Raises:

ValueError – When filter cannot meet ripple spec within a set number of iterations.

Returns:

Filtered data with passband ripple applied.