torch.fft.rfftn

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

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

Преобразование Фурье вещественного сигнала является эрмитово-симметричным, X[i_1, ..., i_n] = conj(X[-i_1, ..., -i_n]) поэтому полный fftn() вывод содержит избыточную информацию. rfftn() вместо этого опускает отрицательные частоты в последнем измерении.

Примечание

Поддерживает torch.half на CUDA с архитектурой GPU SM53 или выше. Однако он поддерживает только длину сигнала, являющуюся степенью 2, во всех преобразуемых измерениях.

Параметры:

• input (Тензор) – входной тензор
• s (Кортеж[int], необязательно) – Размер сигнала в преобразуемых измерениях. Если задано, каждое измерение dim[i] будет либо дополнено нулями, либо усечено до длины s[i] перед вычислением вещественного преобразования Фурье. Если задана длина -1 , заполнение в этом измерении не выполняется. Значение по умолчанию: s = [input.size(d) for d in dim]
• dim (Кортеж[int], необязательно) – Измерения, подлежащие преобразованию. Значение по умолчанию: все измерения или последние len(s) измерения, если s задано.

• norm (str, необязательно) –

  Режим нормализации. Для прямого преобразования (rfftn()), они соответствуют:

  • "forward" - нормализовать по 1/n
  • "backward" - без нормализации
  • "ortho" - нормализовать по 1/sqrt(n) (делая вещественное преобразование Фурье ортогональным)

  Где n = prod(s) - логический размер FFT. Вызов обратного преобразования (irfftn()) с тем же режимом нормализации применит общую нормализацию 1/n между двумя преобразованиями. Это необходимо, чтобы сделать irfftn() точным обратным преобразованием.

  Значение по умолчанию "backward" (без нормализации).

Ключевые аргументы:

out (Тензор, необязательно) – выходной тензор.

Пример

>>> t = torch.rand(10, 10)
>>> rfftn = torch.fft.rfftn(t)
>>> rfftn.size()
torch.Size([10, 6])

В сравнении с полным выводом от fftn(), у нас есть все элементы до частоты Найквиста.

>>> fftn = torch.fft.fftn(t)
>>> torch.testing.assert_close(fftn[..., :6], rfftn, check_stride=False)

Дискретное преобразование Фурье является разделимым, поэтому rfftn() здесь эквивалентно комбинации fft() и rfft():

>>> two_ffts = torch.fft.fft(torch.fft.rfft(t, dim=1), dim=0)
>>> torch.testing.assert_close(rfftn, two_ffts, check_stride=False)