torch.hamming_window

torch.hamming_window(window_length, *, dtype=None, layout=None, device=None, pin_memory=False, requires_grad=False) → Tensor

Hamming 窗函数。

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

其中 $N$ 是完整的窗长。

输入 window_length 是一个正整数，控制返回窗口的大小。 periodic 标志决定返回的窗口是否截去对称窗口的最后一个重复值，以便能与 torch.stft() 等函数一起作为周期性窗口使用。因此，如果 periodic 为 True，则上述公式中的 $N$ 实际上是 $\text{window\_length} + 1$。此外，我们总有 torch.hamming_window(L, periodic=True) 等于 torch.hamming_window(L + 1, periodic=False)[:-1])。

注意

如果 window_length $=1$，则返回的窗口包含单个值 1。

注意

这是 torch.hann_window() 的一个通用版本。

参数

window_length (int) – 返回窗口的大小

关键字参数

• dtype (torch.dtype, optional) – 返回张量的目标数据类型。默认：如果 None，则使用全局默认值（请参阅 torch.set_default_dtype()）。仅支持浮点类型。

• layout (torch.layout, optional) – 返回窗口张量的目标布局。仅支持 torch.strided（密集布局）。

• device (torch.device, 可选) – 返回张量的所需设备。默认：如果为 None，则使用当前设备作为默认张量类型（参见 torch.set_default_device()）。对于 CPU 张量类型，device 将是 CPU；对于 CUDA 张量类型，device 将是当前的 CUDA 设备。

• pin_memory (bool, optional) – 如果设置为 True，则返回的张量将被分配到固定内存中。仅适用于 CPU 张量。默认值：False。

• requires_grad (bool, optional) – 如果 autograd 应记录在返回的张量上的操作。默认值：False。

返回

一个大小为 $(\text{window\_length},)$ 的一维张量，包含窗口。

返回类型

张量

torch.hamming_window(window_length, periodic, *, dtype=None, layout=None, device=None, pin_memory=False, requires_grad=False) → Tensor

指定了 periodic 参数的 Hamming 窗函数。

参数

• window_length (int) – 返回窗口的大小

• periodic (bool) – 如果为 True，则返回一个用作周期性函数的窗口。如果为 False，则返回一个对称窗口。

关键字参数

• dtype (torch.dtype, optional) – 返回张量的目标数据类型。默认：如果 None，则使用全局默认值（请参阅 torch.set_default_dtype()）。仅支持浮点类型。

• layout (torch.layout, optional) – 返回窗口张量的目标布局。仅支持 torch.strided（密集布局）。

• device (torch.device, 可选) – 返回张量的所需设备。默认：如果为 None，则使用当前设备作为默认张量类型（参见 torch.set_default_device()）。对于 CPU 张量类型，device 将是 CPU；对于 CUDA 张量类型，device 将是当前的 CUDA 设备。

• pin_memory (bool, optional) – 如果设置为 True，则返回的张量将被分配到固定内存中。仅适用于 CPU 张量。默认值：False。

• requires_grad (bool, optional) – 如果 autograd 应记录在返回的张量上的操作。默认值：False。

返回

一个大小为 $(\text{window\_length},)$ 的一维张量，包含窗口。

返回类型

张量

torch.hamming_window(window_length, periodic, float alpha, *, dtype=None, layout=None, device=None, pin_memory=False, requires_grad=False) → Tensor

指定了 periodic 和 alpha 参数的 Hamming 窗函数。

参数

• window_length (int) – 返回窗口的大小

• periodic (bool) – 如果为 True，则返回一个用作周期性函数的窗口。如果为 False，则返回一个对称窗口。

• alpha (float) – 上述公式中的系数 $\alpha$

关键字参数

• dtype (torch.dtype, optional) – 返回张量的目标数据类型。默认：如果 None，则使用全局默认值（请参阅 torch.set_default_dtype()）。仅支持浮点类型。

• layout (torch.layout, optional) – 返回窗口张量的目标布局。仅支持 torch.strided（密集布局）。

• device (torch.device, 可选) – 返回张量的所需设备。默认：如果为 None，则使用当前设备作为默认张量类型（参见 torch.set_default_device()）。对于 CPU 张量类型，device 将是 CPU；对于 CUDA 张量类型，device 将是当前的 CUDA 设备。

• pin_memory (bool, optional) – 如果设置为 True，则返回的张量将被分配到固定内存中。仅适用于 CPU 张量。默认值：False。

• requires_grad (bool, optional) – 如果 autograd 应记录在返回的张量上的操作。默认值：False。

返回

一个大小为 $(\text{window\_length},)$ 的一维张量，包含窗口。

返回类型

张量

torch.hamming_window(window_length, periodic, float alpha, float beta, *, dtype=None, layout=None, device=None, pin_memory=False, requires_grad=False) → Tensor

指定了 periodic, alpha 和 beta 参数的 Hamming 窗函数。

参数

• window_length (int) – 返回窗口的大小

• periodic (bool) – 如果为 True，则返回一个用作周期性函数的窗口。如果为 False，则返回一个对称窗口。

• alpha (float) – 上述公式中的系数 $\alpha$

• beta (float) – 上述公式中的系数 $\beta$

关键字参数

• dtype (torch.dtype, optional) – 返回张量的目标数据类型。默认：如果 None，则使用全局默认值（请参阅 torch.set_default_dtype()）。仅支持浮点类型。

• layout (torch.layout, optional) – 返回窗口张量的目标布局。仅支持 torch.strided（密集布局）。

• device (torch.device, 可选) – 返回张量的所需设备。默认：如果为 None，则使用当前设备作为默认张量类型（参见 torch.set_default_device()）。对于 CPU 张量类型，device 将是 CPU；对于 CUDA 张量类型，device 将是当前的 CUDA 设备。

• pin_memory (bool, optional) – 如果设置为 True，则返回的张量将被分配到固定内存中。仅适用于 CPU 张量。默认值：False。

• requires_grad (bool, optional) – 如果 autograd 应记录在返回的张量上的操作。默认值：False。

返回

一个大小为 $(\text{window\_length},)$ 的一维张量，包含窗口。

返回类型

张量