scipy.signal.
sosfiltfilt#
- scipy.signal.sosfiltfilt(sos, x, axis=-1, padtype='odd', padlen=None)[源代码]#
使用级联二阶节进行前向-后向数字滤波。
有关此方法的更完整信息,请参见
filtfilt
。- 参数:
- sosarray_like
二阶滤波器系数数组,必须具有形状
(n_sections, 6)
。每行对应一个二阶节,前三列提供分子系数,后三列提供分母系数。- xarray_like
要过滤的数据数组。
- axisint, 可选
应用滤波器的 x 的轴。默认值为 -1。
- padtypestr 或 None, 可选
必须是 ‘odd’、‘even’、‘constant’ 或 None。这确定用于应用滤波器的填充信号的扩展类型。如果 padtype 为 None,则不使用填充。默认值为 ‘odd’。
- padlenint 或 None, 可选
在应用滤波器之前,x 在 axis 两端扩展的元素数量。此值必须小于
x.shape[axis] - 1
。padlen=0
表示不填充。默认值为3 * (2 * len(sos) + 1 - min((sos[:, 2] == 0).sum(), (sos[:, 5] == 0).sum()))
末尾的额外减法试图补偿原点的极点和零点(例如,对于奇数阶滤波器),以产生与使用
scipy.signal
函数构建的二阶节滤波器的filtfilt
类似的 padlen 估计值。
- 返回:
- yndarray
与 x 形状相同的滤波输出。
另请参阅
说明
在 0.18.0 版本中添加。
示例
>>> import numpy as np >>> from scipy.signal import sosfiltfilt, butter >>> import matplotlib.pyplot as plt >>> rng = np.random.default_rng()
创建一个有趣的信号进行滤波。
>>> n = 201 >>> t = np.linspace(0, 1, n) >>> x = 1 + (t < 0.5) - 0.25*t**2 + 0.05*rng.standard_normal(n)
创建一个低通巴特沃斯滤波器,并用它来过滤 x。
>>> sos = butter(4, 0.125, output='sos') >>> y = sosfiltfilt(sos, x)
为了进行比较,使用
sosfilt
应用一个 8 阶滤波器。使用 x 的前四个值的平均值初始化滤波器。>>> from scipy.signal import sosfilt, sosfilt_zi >>> sos8 = butter(8, 0.125, output='sos') >>> zi = x[:4].mean() * sosfilt_zi(sos8) >>> y2, zo = sosfilt(sos8, x, zi=zi)
绘制结果。请注意,y 的相位与输入匹配,而 y2 有明显的相位延迟。
>>> plt.plot(t, x, alpha=0.5, label='x(t)') >>> plt.plot(t, y, label='y(t)') >>> plt.plot(t, y2, label='y2(t)') >>> plt.legend(framealpha=1, shadow=True) >>> plt.grid(alpha=0.25) >>> plt.xlabel('t') >>> plt.show()