torch.hann_window

torch.hann_window(window_length, periodic=True, *, dtype=None, layout=torch.strided, device=None, requires_grad=False) → Tensor

Функция окна Ханнинга.

$$w[n] = \frac{1}{2}\ \left[1 - \cos \left( \frac{2 \pi n}{N - 1} \right)\right] = \sin^2 \left( \frac{\pi n}{N - 1} \right),$$

где $N$ — полный размер окна.

Вход window_length — целое положительное число, контролирующее размер возвращаемого окна. Флаг periodic определяет, обрезает ли возвращаемое окно последний дублирующий элемент из симметричного окна и готово ли оно для использования в качестве периодического окна с функциями, такими как torch.stft(). Поэтому, если periodic равно true, то $N$ в вышеприведённой формуле фактически равен $\text{window\_length} + 1$. Кроме того, у нас всегда torch.hann_window(L, periodic=True) равно torch.hann_window(L + 1, periodic=False)[:-1]).

Примечание

Если window_length $=1$, возвращаемое окно содержит единственное значение 1.

Параметры:

• window_length (int) — размер возвращаемого окна
• periodic (bool, необязательно) — Если True, возвращает окно для использования в качестве периодической функции. Если False, возвращает симметричное окно.

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

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

Возвращает:

Одномерный тензор размера $(\text{window\_length},)$ содержащий окно

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

Tensor