irfftn#
- scipy.fft.irfftn(x, s=None, axes=None, norm=None, overwrite_x=False, workers=None, *, plan=None)[source]#
计算
rfftn
的逆变换。此函数使用快速傅里叶变换 (FFT) 计算 M 维数组中任意数量轴上实输入的 N 维离散傅里叶变换的逆变换。换句话说,
irfftn(rfftn(x), x.shape) == x
在数值精度范围内成立。(a.shape
与len(a)
相似,对irfft
也是如此,原因相同。)输入应与
rfftn
返回的结果保持一致,即对最后一个变换轴使用与irfft
相同的顺序,对所有其他轴使用与ifftn
相同的顺序。- 参数::
- x类数组
输入数组。
- s整数序列,可选
输出的形状(每个变换轴的长度)(
s[0]
指的是轴 0,s[1]
指的是轴 1,依此类推)。s 也是沿该轴使用的输入点数,最后一个轴除外,最后一个轴使用s[-1]//2+1
个输入点。在任何轴上,如果 s 指定的形状小于输入形状,则裁剪输入。如果大于输入形状,则用零填充输入。如果未指定 s,则使用由 axes 指定的轴上输入的形状。最后一个轴除外,最后一个轴被认为是2*(m-1)
,其中m
是输入沿该轴的长度。- axes整数序列,可选
要计算逆 FFT 的轴。如果未指定,则使用最后 len(s) 个轴,或者如果也未指定 s,则使用所有轴。
- norm{"backward", "ortho", "forward"},可选
归一化模式(参见
fft
)。默认值为 “backward”。- overwrite_x布尔值,可选
如果为 True,则可以销毁 x 的内容;默认值为 False。有关详细信息,请参见
fft
。- workers整数,可选
用于并行计算的最大工作程序数。如果为负数,则该值将从
os.cpu_count()
中循环。有关详细信息,请参见fft
。- plan对象,可选
此参数保留用于传递下游 FFT 供应商提供的预先计算的计划。目前,它在 SciPy 中未使用。
在版本 1.5.0 中添加。
- 返回值::
- outndarray
经过截断或用零填充的输入,沿由 axes 指定的轴进行变换,或由 s 或 x 的组合进行变换,如上面参数部分所述。每个变换轴的长度由 s 的相应元素给出,或者除最后一个轴外,所有轴的输入长度由 s 给出。在最后一个变换轴中,当未指定 s 时,输出长度为
2*(m-1)
,其中m
是输入的最后一个变换轴的长度。为了在最后一个轴上获得奇数个输出点,必须指定 s。
- 引发::
- ValueError
如果 s 和 axes 的长度不同。
- IndexError
如果 axes 的某个元素大于 x 的轴数。
另请参阅
备注
有关使用的定义和约定,请参见
fft
。有关用于实输入的定义和约定,请参见
rfft
。s 的默认值假设在最后一个变换轴中输出长度为偶数。在执行最终的复数到实数变换时,厄米特对称性要求该轴上最后一个虚部必须为 0,因此它被忽略。为了避免丢失信息,必须提供实数输入的正确长度。
示例
>>> import scipy.fft >>> import numpy as np >>> x = np.zeros((3, 2, 2)) >>> x[0, 0, 0] = 3 * 2 * 2 >>> scipy.fft.irfftn(x) array([[[1., 1.], [1., 1.]], [[1., 1.], [1., 1.]], [[1., 1.], [1., 1.]]])