torch.signal.windows.nuttall

torch.signal.windows.nuttall(M, *, sym=True, dtype=None, layout=torch.strided, device=None, requires_grad=False) [source]

Вычисляет окно Блэкмана-Хариса минимальной длины 4 по Нутталу.

$$w_n = 1 - 0.36358 \cos{(z_n)} + 0.48917 \cos{(2z_n)} - 0.13659 \cos{(3z_n)} + 0.01064 \cos{(4z_n)}$$

где z_n = 2 π n/ M.

Окно нормализовано к 1 (максимальное значение равно 1). Однако 1 не отображается, если M чётное и sym равно True.

Параметры

M (int) – длина окна. Другими словами, количество точек возвращаемого окна.

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

• sym (bool, необязательно) – Если False, возвращает периодическое окно, пригодное для использования в спектральном анализе. Если True, возвращает симметричное окно, пригодное для использования в проектировании фильтров. По умолчанию: True.
• dtype (torch.dtype, optional) – желаемый тип данных возвращаемого тензора. По умолчанию: если None, используется глобальный стандарт (см. torch.set_default_tensor_type()).
• layout (torch.layout, optional) – желаемая структура данных возвращаемого тензора. По умолчанию: torch.strided.
• device (torch.device, optional) – желаемое устройство возвращаемого тензора. По умолчанию: если None, используется текущее устройство для типа тензора по умолчанию (см. torch.set_default_tensor_type()). device будет процессором для тензоров на процессоре и текущим устройством CUDA для тензоров CUDA.
• requires_grad (bool, необязательно) – Если autograd должен записывать операции с возвращаемым тензором. По умолчанию: False.

Возвращаемое значение

Тензор

Ссылки:

- A. Nuttall, “Some windows with very good sidelobe behavior,”
  IEEE Transactions on Acoustics, Speech, and Signal Processing, vol. 29, no. 1, pp. 84-91,
  Feb 1981. https://doi.org/10.1109/TASSP.1981.1163506

- Heinzel G. et al., “Spectrum and spectral density estimation by the Discrete Fourier transform (DFT),
  including a comprehensive list of window functions and some new flat-top windows”,
  February 15, 2002 https://holometer.fnal.gov/GH_FFT.pdf

Примеры:

>>> # Generates a symmetric Nutall window.
>>> torch.signal.windows.general_hamming(5, sym=True)
tensor([3.6280e-04, 2.2698e-01, 1.0000e+00, 2.2698e-01, 3.6280e-04])

>>> # Generates a periodic Nuttall window.
>>> torch.signal.windows.general_hamming(5, sym=False)
tensor([3.6280e-04, 1.1052e-01, 7.9826e-01, 7.9826e-01, 1.1052e-01])