scipy.signal.

upfirdn

scipy.signal.upfirdn(h, x, up=1, down=1, axis=-1, mode='constant', cval=0)

上采样、FIR滤波器和下采样。

参数:

harray_like

一维 FIR（有限脉冲响应）滤波器系数。

xarray_like

输入信号数组。

向上int, 可选

上采样率。默认值为 1。

向下int, 可选

下采样率。默认值为 1。

轴int, 可选

输入数据数组的轴，沿此轴应用线性滤波器。滤波器沿此轴应用于每个子数组。默认值为 -1。

模式str, 可选

要使用的信号扩展模式。集合 {"constant", "symmetric", "reflect", "edge", "wrap"} 对应于 numpy.pad 提供的模式。"smooth" 通过基于数组两端最后两点的斜率进行扩展来实现平滑扩展。"antireflect" 和 "antisymmetric" 是 "reflect" 和 "symmetric" 的反对称版本。模式 "line" 根据沿 axis 的第一个和最后一个点的线性趋势扩展信号。

Added in version 1.4.0.

cvalfloat, 可选

当 mode == "constant" 时使用的常量值。

Added in version 1.4.0.

返回:

yndarray

输出信号数组。维度将与 x 相同，除了沿 axis 的维度会根据 h、up 和 down 参数改变大小。

注释

该算法是 Vaidyanathan 文本 [1] 第129页所示的方框图的实现（图4.3-8d）。

通过零插入进行P倍上采样、长度为``N``的FIR滤波以及Q倍下采样的直接方法，每输出样本的复杂度为O(N*Q)。这里使用的多相实现复杂度为O(N/P)。

Added in version 0.18.

参考文献

[1]

P. P. Vaidyanathan, Multirate Systems and Filter Banks, Prentice Hall, 1993.

示例

Try it in your browser!

简单操作：

>>> import numpy as np
>>> from scipy.signal import upfirdn
>>> upfirdn([1, 1, 1], [1, 1, 1])   # FIR filter
array([ 1.,  2.,  3.,  2.,  1.])
>>> upfirdn([1], [1, 2, 3], 3)  # upsampling with zeros insertion
array([ 1.,  0.,  0.,  2.,  0.,  0.,  3.])
>>> upfirdn([1, 1, 1], [1, 2, 3], 3)  # upsampling with sample-and-hold
array([ 1.,  1.,  1.,  2.,  2.,  2.,  3.,  3.,  3.])
>>> upfirdn([.5, 1, .5], [1, 1, 1], 2)  # linear interpolation
array([ 0.5,  1. ,  1. ,  1. ,  1. ,  1. ,  0.5])
>>> upfirdn([1], np.arange(10), 1, 3)  # decimation by 3
array([ 0.,  3.,  6.,  9.])
>>> upfirdn([.5, 1, .5], np.arange(10), 2, 3)  # linear interp, rate 2/3
array([ 0. ,  1. ,  2.5,  4. ,  5.5,  7. ,  8.5])

将单个滤波器应用于多个信号：

>>> x = np.reshape(np.arange(8), (4, 2))
>>> x
array([[0, 1],
       [2, 3],
       [4, 5],
       [6, 7]])

沿 x 的最后一个维度应用：

>>> h = [1, 1]
>>> upfirdn(h, x, 2)
array([[ 0.,  0.,  1.,  1.],
       [ 2.,  2.,  3.,  3.],
       [ 4.,  4.,  5.,  5.],
       [ 6.,  6.,  7.,  7.]])

沿 x 的第0维度应用：

>>> upfirdn(h, x, 2, axis=0)
array([[ 0.,  1.],
       [ 0.,  1.],
       [ 2.,  3.],
       [ 2.,  3.],
       [ 4.,  5.],
       [ 4.,  5.],
       [ 6.,  7.],
       [ 6.,  7.]])

Go BackOpen In Tab