torch.bartlett_window

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

Bartlett window function.

$$w[n] = 1 - \left| \frac{2n}{N-1} - 1 \right| = \begin{cases} \frac{2n}{N - 1} & \text{if } 0 \leq n \leq \frac{N - 1}{2} \\ 2 - \frac{2n}{N - 1} & \text{if } \frac{N - 1}{2} < n < N \\ \end{cases},$$

其中 $N$ 是完整窗口的大小。

输入 window_length 是一个控制返回窗口大小的正整数。periodic 标志确定返回的窗口是否会截断对称窗口的最后一个重复值，并准备好用于 torch.stft() 等函数。因此，如果 periodic 为 true，则上述公式中的 $N$ 实际上是 $\text{window\_length} + 1$。另外，我们总是有 torch.bartlett_window(L, periodic=True) 等于 torch.bartlett_window(L + 1, periodic=False)[:-1])。

注意

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

参数

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

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

关键字参数

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

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

• device (torch.device, optional) – 返回张量的期望设备。默认值：如果 None，则使用当前设备作为默认张量类型（请参阅 torch.set_default_device()）。对于 CPU 张量类型，device 将是 CPU；对于 CUDA 张量类型，它将是当前 CUDA 设备。

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

返回

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

返回类型

张量