torch.fft.irfftn

torch.fft.irfftn(input, s=None, dim=None, norm=None, *, out=None) → Tensor

計算 rfftn() 的逆變換。

input 被解釋為傅立葉域中的單邊厄米訊號，由 rfftn() 生成。根據厄米特性，輸出將是實值。

注意

為了滿足厄米性質，某些輸入頻率必須是實數值。在這種情況下，虛部將被忽略。例如，零頻率項中的任何虛部都無法在實數輸出中表示，因此將被始終忽略。

注意

厄米輸入的正確解釋取決於原始資料的長度，由 s 指定。這是因為每個輸入形狀都可以對應奇數或偶數長度的訊號。預設情況下，假定訊號是偶數長度，奇數訊號將無法正確進行往返變換。因此，建議始終傳入訊號形狀 s。

注意

支援 CUDA 上的 torch.half 和 torch.chalf（GPU 架構 SM53 或更高）。但是，它僅支援每個變換維度中 2 的冪次訊號長度。使用預設引數時，最後一個維度的大小應為 (2^n + 1)，因為引數 s 預設為偶數輸出大小 = 2 * (last_dim_size - 1)。

引數

• input (Tensor) – 輸入張量

• s (Tuple[int], optional) – 變換維度中的訊號大小。如果給定，則在計算實數 FFT 之前，每個維度 dim[i] 將被零填充或截斷到長度 s[i]。如果指定長度為 -1，則該維度不進行填充。預設值為最後一個維度中的偶數輸出：s[-1] = 2*(input.size(dim[-1]) - 1)。

• dim (Tuple[int], optional) – 要進行變換的維度。最後一個維度必須是半厄米壓縮維度。預設：所有維度，或如果指定了 s，則為 len(s) 個最後一個維度。

• norm (str, optional) –

  歸一化模式。對於反向變換（irfftn()），這些對應於

  • "forward" - 無歸一化

  • "backward" - 按 1/n 歸一化

  • "ortho" - 按 1/sqrt(n) 歸一化（使實值 IFFT 正交化）

  其中 n = prod(s) 是邏輯 IFFT 大小。使用相同的歸一化模式呼叫正向變換（rfftn()）將在兩次變換之間應用 1/n 的整體歸一化。這是使 irfftn() 成為精確逆變換所必需的。

  預設為 "backward"（按 1/n 歸一化）。

關鍵字引數

out (Tensor, optional) – 輸出張量。

示例

>>> t = torch.rand(10, 9)
>>> T = torch.fft.rfftn(t)

不向 irfft() 指定輸出長度，輸出將無法正確往返，因為最後一個維度的輸入是奇數長度。

>>> torch.fft.irfftn(T).size()
torch.Size([10, 8])

因此，建議始終傳遞訊號形狀 s。

>>> roundtrip = torch.fft.irfftn(T, t.size())
>>> roundtrip.size()
torch.Size([10, 9])
>>> torch.testing.assert_close(roundtrip, t, check_stride=False)