torchsig.transforms.functional.spurs

torchsig.transforms.functional.spurs(data: ndarray, sample_rate: float = 1, center_freqs=[0.25], relative_power_db=[3], noise_power_db: float | None = None) → ndarray[source]

Adds spurs to the input data.

This function adds spurious signals (tones) at specified frequencies with specified power levels.

Parameters:

  • data – IQ data samples.

  • sample_rate – Sample rate associated with the samples. Defaults to 1.

  • center_freqs – Center frequencies for the spurs. Defaults to [0.25].

  • relative_power_db – Relative power of spurs in dB to noise floor. Defaults to [3].

  • noise_power_db – Noise floor power in dB. Estimated internally if not provided. Defaults to None.

Returns:

IQ data with spurs (tones) added.

Raises:

ValueError – If center_freqs are outside the valid range or if lengths don’t match.