tensorplay.signal.windows.general_hamming

tensorplay.signal.windows.general_hamming(M, *, alpha: float = 0.54, sym: bool = True, dtype: dtype | None = None, layout: Layout = tensorplay.strided, device: device | None = None, requires_grad: bool = False) → Tensor[source]

Computes the general Hamming window, the two-term member of the general cosine family.

The samples are

$$w_n = \alpha - (1 - \alpha) \cos{ \left( \frac{2 \pi n}{M-1} \right)}$$

The window is scaled so that its largest value is 1. The value 1 itself does not occur when M is even and sym is True.

Parameters:

M (int) – number of points of the returned window.

Keyword Arguments:

• alpha (float, optional) – the window coefficient. Default: 0.54.

• sym (bool, optional) – if False, returns a periodic window, which is the usual choice for spectral analysis. If True, returns a symmetric window, which is the usual choice for filter design. Default: True.

• dtype (tensorplay.dtype, optional) – the desired data type of the returned tensor. Default: if None, uses the global default (see tensorplay.set_default_dtype()).

• layout (tensorplay.Layout, optional) – the desired layout of the returned tensor. Default: tensorplay.strided.

• device (tensorplay.device, optional) – the desired device of the returned tensor. Default: if None, uses the current default tensor device (see tensorplay.set_default_device()).

• requires_grad (bool, optional) – whether autograd should record operations on the returned tensor. Default: False.

Examples:

>>> # Symmetric Hamming window via the general Hamming builder.
>>> tensorplay.signal.windows.general_hamming(10, sym=True)
tensor([0.08, 0.1876, 0.4601, 0.77, 0.9723, 0.9723, 0.77, 0.4601, 0.1876, 0.08])

>>> # Periodic Hann window via the general Hamming builder.
>>> tensorplay.signal.windows.general_hamming(10, alpha=0.5, sym=False)
tensor([0., 0.0955, 0.3455, 0.6545, 0.9045, 1., 0.9045, 0.6545, 0.3455, 0.0955])