scipy.signal.

freqz_sos#

scipy.signal.freqz_sos(sos, worN=512, whole=False, fs=6.283185307179586)[source]#

计算 SOS 格式数字滤波器的频率响应。

给定 sos,一个形状为 (n, 6) 的数字滤波器二阶节数组,计算系统函数的频率响应

       B0(z)   B1(z)         B{n-1}(z)
H(z) = ----- * ----- * ... * ---------
       A0(z)   A1(z)         A{n-1}(z)

其中 z = exp(omega*1j),B{k}(z) 和 A{k}(z) 分别是第 k 个二阶节传递函数的分子和分母。

参数:
sos类数组

二阶滤波器系数数组,形状必须为 (n_sections, 6)。每行对应一个二阶节,前三列提供分子系数,后三列提供分母系数。

worN{None, int, 类数组}, 可选

如果为单个整数,则在该数量的频率上进行计算(默认 N=512)。使用对 FFT 计算有利的数字可以加快计算速度(参见 freqz 的注意事项)。

如果为类数组,则在给定频率上计算响应(必须为 1-D)。这些频率的单位与 fs 相同。

whole布尔, 可选

通常,频率从 0 计算到奈奎斯特频率 fs/2(单位圆上半部分)。如果 whole 为 True,则频率从 0 计算到 fs。

fs浮点数, 可选

数字系统的采样频率。默认为 2*pi 弧度/采样(因此 w 的范围是 0 到 pi)。

在版本 1.2.0 中新增。

返回值:
wndarray

计算 h 时的频率,单位与 fs 相同。默认情况下,w 被归一化到 [0, pi) 范围(弧度/采样)。

hndarray

频率响应,以复数形式表示。

另请参阅

freqz, sosfilt, sosfreqz

注意事项

在旧版本(≥ 0.19.0)中,此函数曾被称为 sosfreqz

在版本 1.15.0 中新增。

示例

设计一个 15 阶 SOS 格式带通滤波器。

>>> from scipy import signal
>>> import numpy as np
>>> sos = signal.ellip(15, 0.5, 60, (0.2, 0.4), btype='bandpass',
...                    output='sos')

计算从直流到奈奎斯特频率的 1500 个点的频率响应。

>>> w, h = signal.freqz_sos(sos, worN=1500)

绘制响应曲线。

>>> import matplotlib.pyplot as plt
>>> plt.subplot(2, 1, 1)
>>> db = 20*np.log10(np.maximum(np.abs(h), 1e-5))
>>> plt.plot(w/np.pi, db)
>>> plt.ylim(-75, 5)
>>> plt.grid(True)
>>> plt.yticks([0, -20, -40, -60])
>>> plt.ylabel('Gain [dB]')
>>> plt.title('Frequency Response')
>>> plt.subplot(2, 1, 2)
>>> plt.plot(w/np.pi, np.angle(h))
>>> plt.grid(True)
>>> plt.yticks([-np.pi, -0.5*np.pi, 0, 0.5*np.pi, np.pi],
...            [r'$-\pi$', r'$-\pi/2$', '0', r'$\pi/2$', r'$\pi$'])
>>> plt.ylabel('Phase [rad]')
>>> plt.xlabel('Normalized frequency (1.0 = Nyquist)')
>>> plt.show()
../../_images/scipy-signal-freqz_sos-1_00_00.png

如果将相同的滤波器实现为单个传递函数,则数值误差会损坏频率响应

>>> b, a = signal.ellip(15, 0.5, 60, (0.2, 0.4), btype='bandpass',
...                    output='ba')
>>> w, h = signal.freqz(b, a, worN=1500)
>>> plt.subplot(2, 1, 1)
>>> db = 20*np.log10(np.maximum(np.abs(h), 1e-5))
>>> plt.plot(w/np.pi, db)
>>> plt.ylim(-75, 5)
>>> plt.grid(True)
>>> plt.yticks([0, -20, -40, -60])
>>> plt.ylabel('Gain [dB]')
>>> plt.title('Frequency Response')
>>> plt.subplot(2, 1, 2)
>>> plt.plot(w/np.pi, np.angle(h))
>>> plt.grid(True)
>>> plt.yticks([-np.pi, -0.5*np.pi, 0, 0.5*np.pi, np.pi],
...            [r'$-\pi$', r'$-\pi/2$', '0', r'$\pi/2$', r'$\pi$'])
>>> plt.ylabel('Phase [rad]')
>>> plt.xlabel('Normalized frequency (1.0 = Nyquist)')
>>> plt.show()
../../_images/scipy-signal-freqz_sos-1_01_00.png