scipy.fft.

hfft#

scipy.fft.hfft(x, n=None, axis=-1, norm=None, overwrite_x=False, workers=None, *, plan=None)[source]#

计算具有厄米特对称性的信号的 FFT，即实谱。

参数:

xarray_like: 输入数组。
nint, 可选: 输出变换轴的长度。对于 n 个输出点，需要 n//2 + 1 个输入点。如果输入比这更长，则会被裁剪。如果它比这更短，则会用零填充。如果未给出 n，则取值为 2*(m-1)，其中 m 是由 axis 指定的轴上输入的长度。
axisint, 可选: 要计算 FFT 的轴。如果未给出，则使用最后一个轴。
norm{“backward”, “ortho”, “forward”}, 可选: 归一化模式（见 fft）。默认值为“backward”。
overwrite_xbool, 可选: 如果为 True，则可以销毁 x 的内容；默认值为 False。有关更多详细信息，请参见 fft。
workersint, 可选: 用于并行计算的最大工作线程数。如果为负数，该值将从 os.cpu_count() 中包裹。有关更多详细信息，请参见 fft。
planobject, 可选: 此参数保留用于传递由下游 FFT 供应商提供的预先计算的计划。目前在 SciPy 中未使用。

在版本 1.5.0 中添加。

返回值:

outndarray: 沿由 axis 指定的轴（或未指定 axis 时使用最后一个轴）变换的截断或用零填充的输入。变换轴的长度为 n，或者，如果未给出 n，则为 2*m - 2，其中 m 是输入变换轴的长度。要获得奇数个输出点，必须指定 n，例如，在典型情况下指定为 2*m - 1，

引发:

IndexError: 如果 axis 大于 a 的最后一个轴。

另请参见

rfft: 计算实输入的 1-D FFT。
ihfft: hfft 的逆。
hfftn: 计算厄米特信号的 N-D FFT。

注释

hfft/ihfft 是一对类似于 rfft/irfft，但情况相反：这里信号在时域具有厄米特对称性，而在频域为实数。因此，这里有 hfft，您必须提供结果的长度，如果结果是奇数。* 偶数：ihfft(hfft(a, 2*len(a) - 2) == a，在舍入误差范围内，* 奇数：ihfft(hfft(a, 2*len(a) - 1) == a，在舍入误差范围内。

示例

>>> from scipy.fft import fft, hfft
>>> import numpy as np
>>> a = 2 * np.pi * np.arange(10) / 10
>>> signal = np.cos(a) + 3j * np.sin(3 * a)
>>> fft(signal).round(10)
array([ -0.+0.j,   5.+0.j,  -0.+0.j,  15.-0.j,   0.+0.j,   0.+0.j,
        -0.+0.j, -15.-0.j,   0.+0.j,   5.+0.j])
>>> hfft(signal[:6]).round(10) # Input first half of signal
array([  0.,   5.,   0.,  15.,  -0.,   0.,   0., -15.,  -0.,   5.])
>>> hfft(signal, 10)  # Input entire signal and truncate
array([  0.,   5.,   0.,  15.,  -0.,   0.,   0., -15.,  -0.,   5.])