scipy.fft.

rfftn#

scipy.fft.rfftn(x, s=None, axes=None, norm=None, overwrite_x=False, workers=None, *, plan=None)[原始碼]#

計算實數輸入的 N 維離散傅立葉轉換。

此函數藉由快速傅立葉轉換 (FFT) 計算 M 維實數陣列中任意數量的軸上的 N 維離散傅立葉轉換。預設情況下，所有軸都會轉換，實數轉換會在最後一個軸上執行，而其餘轉換則為複數。

參數:

xarray_like: 輸入陣列，視為實數。
ssequence of ints, optional: 要從輸入中使用的形狀（每個轉換軸的長度）。（s[0] 參考軸 0，s[1] 參考軸 1，依此類推）。 s 的最後一個元素對應於 rfft(x, n) 的 n，而對於其餘軸，它對應於 fft(x, n) 的 n。沿任何軸，如果給定的形狀小於輸入的形狀，則會裁剪輸入。如果它更大，則輸入會以零填充。如果未給定 s，則使用輸入沿 axes 指定軸的形狀。
axessequence of ints, optional: 要計算 FFT 的軸。如果未給定，則使用最後 len(s) 個軸，如果也未指定 s，則使用所有軸。
norm{“backward”, “ortho”, “forward”}, optional: 正規化模式（請參閱 fft）。預設值為 “backward”。
overwrite_xbool, optional: 如果為 True，則可以銷毀 x 的內容；預設值為 False。請參閱 fft 以取得更多詳細資訊。
workersint, optional: 用於平行計算的最大工作人員數量。如果為負數，則值會從 os.cpu_count() 包裝。請參閱 fft 以取得更多詳細資訊。
planobject, optional: 此引數保留用於傳入下游 FFT 供應商提供的預先計算的計劃。目前 SciPy 中未使用它。

在版本 1.5.0 中新增。

返回:

outcomplex ndarray: 沿 axes 指示的軸，或透過 s 和 x 的組合轉換的截斷或零填充輸入，如以上參數章節中所述。最後一個轉換軸的長度將為 s[-1]//2+1，而其餘轉換軸的長度將根據 s，或與輸入保持不變。

引發:

ValueError: 如果 s 和 axes 的長度不同。
IndexError: 如果 axes 的元素大於 x 的軸數。

參見

irfftn: rfftn 的反函數，即實數輸入的 N 維 FFT 的反函數。
fft: 1 維 FFT，具有使用的定義和慣例。
rfft: 實數輸入的 1 維 FFT。
fftn: N 維 FFT。
rfft2: 實數輸入的 2 維 FFT。

註解

實數輸入的轉換在最後一個轉換軸上執行，如 rfft 所示，然後其餘軸上的轉換如 fftn 所示執行。輸出的順序對於最後一個轉換軸如同 rfft，對於其餘轉換軸如同 fftn。

有關使用的詳細資訊、定義和慣例，請參閱 fft。

範例

>>> import scipy.fft
>>> import numpy as np
>>> x = np.ones((2, 2, 2))
>>> scipy.fft.rfftn(x)
array([[[8.+0.j,  0.+0.j], # may vary
        [0.+0.j,  0.+0.j]],
       [[0.+0.j,  0.+0.j],
        [0.+0.j,  0.+0.j]]])

>>> scipy.fft.rfftn(x, axes=(2, 0))
array([[[4.+0.j,  0.+0.j], # may vary
        [4.+0.j,  0.+0.j]],
       [[0.+0.j,  0.+0.j],
        [0.+0.j,  0.+0.j]]])