torch.signal.windows.windows.nuttall

torch.signal.windows.windows.nuttall(M, *, sym=True, dtype=None, layout=torch.strided, device=None, requires_grad=False) [исходный код]

Вычисляет минимальное окно Блэкмана — Харриса из 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 = \frac{2 \pi n}{M}$.

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

Параметры:

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

Именованные аргументы:

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

Тип возвращаемого значения:

Tensor

Ссылки:

- 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 Nuttall 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])