torch.fft.hfft2¶
- torch.fft.hfft2(input, s=None, dim=(-2, -1), norm=None, *, out=None) 张量¶
计算Hermitian对称输入信号的二维离散傅里叶变换。等效于
hfftn(),但默认仅转换最后两个维度。input被解释为时域中的一侧厄米信号。根据厄米性质,傅里叶变换将是实值的。注意
支持在CUDA上使用GPU架构SM53或更高版本的torch.half和torch.chalf。 然而,它仅支持每个变换维度中信号长度为2的幂次方。 使用默认参数时,最后一个维度的大小应为(2^n + 1),因为参数s默认为偶数输出大小 = 2 * (last_dim_size - 1)
- Parameters
输入 (张量) – 输入张量
s (元组[int], 可选) – 变换维度中的信号大小。 如果给定,每个维度
dim[i]将在计算厄米特傅里叶变换之前被零填充或 修剪到长度s[i]。 如果指定了长度-1,则在该维度上不进行填充。 默认为最后一个维度中的偶数输出:s[-1] = 2*(input.size(dim[-1]) - 1)。dim (Tuple[int], 可选) – 要转换的维度。 最后一个维度必须是半厄米压缩维度。 默认值:最后两个维度。
norm (str, optional) –
归一化模式。对于正向变换 (
hfft2()), 这些对应于:"forward"- 归一化因子为1/n"backward"- 不进行归一化"ortho"- 归一化因子为1/sqrt(n)(使 Hermitian FFT 正交归一化)
其中
n = prod(s)是逻辑 FFT 大小。 调用反向变换 (ihfft2()) 并使用相同的 归一化模式将在两次变换之间应用总体归一化因子1/n。这是为了使ihfft2()成为精确的逆变换。默认值为
"backward"(不进行归一化)。
- Keyword Arguments
输出 (张量, 可选) – 输出张量。
示例
从实频率空间信号开始,我们可以生成一个厄米特对称的时间域信号: >>> T = torch.rand(10, 9) >>> t = torch.fft.ihfft2(T)
如果不指定输出长度给
hfftn(),输出将无法正确往返,因为输入在最后一个维度上的长度是奇数:>>> torch.fft.hfft2(t).size() torch.Size([10, 10])
因此,建议始终传递信号形状
s。>>> roundtrip = torch.fft.hfft2(t, T.size()) >>> roundtrip.size() torch.Size([10, 9]) >>> torch.allclose(roundtrip, T) True