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, 可选

在应用滤波器之前,xaxis 两端扩展的元素数量。此值必须小于 x.shape[axis] - 1padlen=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()
../../_images/scipy-signal-sosfiltfilt-1.png