maxframe.tensor.fft.irfft#

maxframe.tensor.fft.irfft(a, n=None, axis=-1, norm=None)[源代码]#

计算实数输入的 n 点 DFT 的逆变换。

该函数计算由 rfft 计算的实数输入的一维 n 点离散傅里叶变换的逆变换。换句话说,irfft(rfft(a), len(a)) == a 在数值精度范围内成立。(请参见下面的说明了解为什么这里需要 len(a)。)

输入应为 rfft 返回的形式,即实数零频率项后接按频率递增顺序排列的复数正频率项。由于实数输入的离散傅里叶变换是厄米特对称的,负频率项被视作相应正频率项的复共轭。

参数:
  • a (array_like) -- 输入张量。

  • n (int, optional) -- 输出变换轴的长度。对于 n 个输出点,需要 n//2+1 个输入点。如果输入比这长,则会被裁剪;如果比这短,则会用零填充。如果未指定 n,则根据 axis 指定轴上的输入长度来确定。

  • axis (int, optional) -- 用于计算逆 FFT 的轴。如果未指定,则使用最后一个轴。

  • norm ({None, "ortho"}, optional) -- 归一化模式(参见 mt.fft)。默认为 None。

返回:

out -- 经过截断或零填充的输入,在由 axis 指定的轴(若未指定则为最后一个轴)上进行变换。变换轴的长度为 n,若未指定 n,则为 2*(m-1),其中 m 是输入的变换轴长度。若要获得奇数个输出点,必须指定 n

返回类型:

Tensor

抛出:

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

参见

mt.fft

关于 DFT 的定义和所用约定。

rfft

实数输入的一维 FFT,irfft 是其逆变换。

fft

一维 FFT。

irfft2

实数输入的二维 FFT 的逆变换。

irfftn

实数输入的 n 维 FFT 的逆变换。

备注

返回 a 的实数值 n 点逆离散傅里叶变换,其中 a 包含厄米特对称序列的非负频率项。n 是结果的长度,而不是输入的长度。

如果指定一个 n 使得 a 必须进行零填充或截断,则额外/被移除的值将在高频处添加/移除。因此可以通过傅里叶插值将序列重采样为 m 个点:a_resamp = irfft(rfft(a), m)

示例

>>> import maxframe.tenosr as mt
>>> mt.fft.ifft([1, -1j, -1, 1j]).execute()
array([ 0.+0.j,  1.+0.j,  0.+0.j,  0.+0.j])
>>> mt.fft.irfft([1, -1j, -1]).execute()
array([ 0.,  1.,  0.,  0.])

注意普通 ifft 输入中的最后一项是第二项的复共轭,且输出在所有位置的虚部均为零。调用 irfft 时,不指定负频率,输出数组为纯实数。