numpy.fft.ifft2

fft.ifft2(a, s=None, axes=(-2, -1), norm=None, out=None)[source]

Вычислить двумерное обратное дискретное преобразование Фурье.

Эта функция вычисляет обратное двумерное дискретное преобразование Фурье по любому числу осей в массиве размерности M с помощью быстрого преобразования Фурье (FFT). Другими словами, ifft2(fft2(a)) == a с точностью до числовой точности. По умолчанию обратное преобразование вычисляется по двум последним осям входного массива.

Входной массив, аналогично ifft, должен быть упорядочен так же, как возвращает fft2, т.е. он должен иметь член для нулевой частоты в углу с меньшими индексами по двум осям, положительные частоты в первой половине этих осей, член для частоты Найквиста посередине осей и отрицательные частоты во второй половине обеих осей, в порядке убывания отрицательной частоты.

Parameters:

aarray_like

Входной массив, может быть комплексным.

sпоследовательность целых чисел, необязательно

Форма (длина каждой оси) выходного значения (s[0] относится к оси 0, s[1] к оси 1 и т.д.). Это соответствует n для ifft(x, n). По каждой оси, если заданная форма меньше формы входных данных, входные данные обрезаются. Если она больше, входные данные дополняются нулями.

Изменено в версии 2.0: Если она -1, весь вход используется (без дополнения/обрезания).

Если s не задана, используется форма входных данных по осям, заданным axes. См. примечания для вопроса об ifft дополнение нулями.

Устарело начиная с версии 2.0: Если s не None, axes не должно быть None.

Устарело начиная с версии 2.0: s должна содержать только int, а не None значения. None значения в настоящее время означают, что используется значение по умолчанию для n, но это поведение устарело.

axesпоследовательность целых чисел, необязательно

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

Устарело начиная с версии 2.0: Если s указана, соответствующая axes для преобразования не должна быть None.

norm{“backward”, “ortho”, “forward”}, необязательно

Новое в версии 1.10.0.

Режим нормализации (см. numpy.fft). По умолчанию «backward». Указывает, какая из направлений прямого/обратного преобразования масштабируется и с каким нормировочным коэффициентом.

Новое в версии 1.20.0: Были добавлены значения «backward», «forward».

outкомплексный массив ndarray, необязательно

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

Новое в версии 2.0.0.

Returns:

outкомплексный массив ndarray

Усеченный или дополненный нулями входной массив, преобразованный по осям, указанным axes, или по двум последним осям, если axes не задан.

Raises:

ValueError

Если s и axes имеют различную длину, или axes не задано и len(s) != 2.

IndexError

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

См. также

numpy.fft

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

fft2

Прямое двумерное FFT, обратным к которому является ifft2.

ifftn

Обратное преобразование n-мерного FFT.

fft

Одномерное FFT.

ifft

Обратное одномерное FFT.

Примечания

ifft2 — это просто ifftn с другим значением по умолчанию для axes.

См. ifftn для подробностей и примера построения графиков, и numpy.fft для определения и используемых соглашений.

Дополнение нулями, аналогично ifft, выполняется путем добавления нулей к входным данным по указанной размерности. Хотя это общий подход, он может привести к неожиданным результатам. Если нужно другое дополнение нулями, его следует выполнить до вызова ifft2.

Примеры

>>> a = 4 * np.eye(4)
>>> np.fft.ifft2(a)
array([[1.+0.j,  0.+0.j,  0.+0.j,  0.+0.j], # may vary
       [0.+0.j,  0.+0.j,  0.+0.j,  1.+0.j],
       [0.+0.j,  0.+0.j,  1.+0.j,  0.+0.j],
       [0.+0.j,  1.+0.j,  0.+0.j,  0.+0.j]])