torchaudio.functional.lfilter

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

通过评估差分方程执行 IIR 滤波，使用 Yu 等 [Yu and Fazekas, 2023] 和 Forgione 等 [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，则波形至少应为 2D，并且从最后一个轴开始的第二个轴的大小应等于 num_filters。输出可以表示为 output[..., i, :] = lfilter(waveform[..., i, :], a_coeffs[i], b_coeffs[i], clamp=clamp, batching=False)。（默认：True）

返回值：

如果 a_coeffs 和 b_coeffs 为 2D 张量，则尺寸为 (…, num_filters, time) 的波形，否则为 (…, time)。

返回值类型：

张量