numpy.fft.irfftn

numpy.fft.irfftn(a, s=None, axes=None, norm=None) [source]

Вычислить обратное N-мерное преобразование Фурье для вещественного входного сигнала.

Эта функция вычисляет обратное N-мерное дискретное преобразование Фурье для вещественного входного сигнала по любому числу осей в M-мерном массиве с помощью быстрого преобразования Фурье (FFT). Другими словами, irfftn(rfftn(a), a.shape) == a с точностью до погрешности вычисления. (Такое a.shape необходимо, как и len(a) для irfft, и по той же причине.)

Входные данные должны быть упорядочены так же, как возвращает rfftn, т. е. как для irfft по оси конечного преобразования и как для ifftn по всем другим осям.

Параметры

aarray_like

Входной массив.

ssequence of ints, optional

Форма (длина каждой преобразованной оси) выходных данных (s[0] относится к оси 0, s[1] к оси 1 и т.д.). s также является числом входных точек, используемых вдоль этой оси, за исключением последней оси, где используется s[-1]//2+1 точек входных данных. Вдоль любой оси, если форма, указанная s, меньше, чем форма входных данных, входные данные обрезаются. Если она больше, входные данные заполняются нулями. Если s не указано, используется форма входных данных вдоль осей, указанных в axessequence of ints, optional. За исключением последней оси, которая принимается равной 2*(m-1), где m — длина входных данных вдоль этой оси.

axessequence of ints, optional

Оси, по которым вычисляется обратное FFT. Если не указано, используются последние len(s) оси или все оси, если s также не указано. Повторные индексы в axes означают, что обратное преобразование по этой оси выполняется несколько раз.

norm{None, “ortho”}, optional

Добавлена в версии 1.10.0.

Режим нормализации (см. numpy.fft). По умолчанию None.

Возвращает

outndarray

Обрезанные или дополненные нулями входные данные, преобразованные вдоль осей, указанных в axes, или по комбинации s или a, как описано в разделе параметров выше. Длина каждой преобразованной оси задается соответствующим элементом s, или длиной входных данных по каждой оси, кроме последней, если s не указано. На последней преобразованной оси длина выходных данных, если s не указано, составляет 2*(m-1), где m — длина последней преобразованной оси входных данных. Чтобы получить нечетное число выходных точек на конечной оси, s должно быть указано.

Возбуждает

ValueError

Если s и axes имеют различную длину.

IndexError

Если элемент axes больше, чем количество осей в a.

См. также

rfftn

Прямое n-мерное преобразование Фурье для вещественного входного сигнала, обратное преобразование к которому — ifftn.

fft

Одномерное преобразование Фурье с определениями и используемыми соглашениями.

irfft

Обратное одномерное преобразование Фурье для вещественного входного сигнала.

irfft2

Обратное двумерное преобразование Фурье для вещественного входного сигнала.

Замечания

См. fft для определений и используемых соглашений.

См. rfft для определений и используемых соглашений для вещественного входного сигнала.

Корректная интерпретация эрмитова входного сигнала зависит от формы исходных данных, как указано в s. Это связано с тем, что каждая форма входных данных может соответствовать либо сигналу с нечетной, либо четной длиной. По умолчанию irfftn предполагает четную длину выходных данных, что помещает последний элемент в частоту Найквиста; алиасирование с его симметричным аналогом. При выполнении конечного преобразования от комплексного к вещественному, последнее значение, таким образом, рассматривается как чисто вещественное. Чтобы избежать потери информации, необходимо указать правильную форму вещественного входного сигнала.

Примеры

>>> a = np.zeros((3, 2, 2))
>>> a[0, 0, 0] = 3 * 2 * 2
>>> np.fft.irfftn(a)
array([[[1.,  1.],
        [1.,  1.]],
       [[1.,  1.],
        [1.,  1.]],
       [[1.,  1.],
        [1.,  1.]]])