torchaudio.functional.lfilter

torchaudio.functional.lfilter(waveform: Tensor, a_coeffs: Tensor, b_coeffs: Tensor, clamp: bool = True, batching: bool = True) → Tensor

通过评估差分方程执行 IIR 滤波，使用由 Yu et al. [Yu and Fazekas, 2023] 和 Forgione et al. [Forgione and Piga, 2021] 独立开发的、可微分的实现。

注意

为避免数值问题，优选使用较小的滤波器阶数。使用双精度也可以最大限度地减少数值精度误差。

参数:

• waveform (Tensor) – 维度为 (…, time) 的音频波形。必须归一化到 -1 到 1 的范围。

• a_coeffs (Tensor) – 差分方程的分母系数，维度为 1D，形状为 (num_order + 1)，或 2D，形状为 (num_filters, num_order + 1)。延迟较低的系数在前，例如 [a0, a1, a2, ...]。必须与 b_coeffs 大小相同（必要时用 0 填充）。

• b_coeffs (Tensor) – 差分方程的分子系数，维度为 1D，形状为 (num_order + 1)，或 2D，形状为 (num_filters, num_order + 1)。延迟较低的系数在前，例如 [b0, b1, b2, ...]。必须与 a_coeffs 大小相同（必要时用 0 填充）。

• clamp (bool, optional) – 如果为 True，则将输出信号限制在 [-1, 1] 的范围内（默认值: True）

• batching (bool, optional) – 仅当系数为 2D 时有效。如果为 True，则波形 waveform 应该至少为 2D，并且倒数第二个轴的大小应等于 num_filters。输出可以表示为 output[..., i, :] = lfilter(waveform[..., i, :], a_coeffs[i], b_coeffs[i], clamp=clamp, batching=False)。 (默认值: True)

返回值:

如果 a_coeffs 和 b_coeffs 是 2D Tensors，则返回维度为 (…, num_filters, time) 的波形，否则返回维度为 (…, time) 的波形。

返回类型:

Tensor