torch.signal.windows.general_cosine

torch.signal.windows.general_cosine(M, *, a, sym=True, dtype=None, layout=torch.strided, device=None, requires_grad=False)

計算一般餘弦窗。

一般餘弦窗定義如下

$$w_n = \sum^{M-1}_{i=0} (-1)^i a_i \cos{ \left( \frac{2 \pi i n}{M - 1}\right)}$$

窗口已正規化為 1（最大值為 1）。然而，如果 M 是偶數且 sym 為 True，則不會出現 1。

參數

M (int) – 窗口的長度。換句話說，傳回的窗口的點數。

關鍵字參數

• a (Iterable) – 與每個餘弦函數相關聯的係數。

• sym (bool, optional) – 如果 False，則傳回適用於頻譜分析的週期性窗口。如果 True，則傳回適用於濾波器設計的對稱窗口。預設值：True。

• dtype (torch.dtype, optional) – 傳回張量的所需資料類型。預設值：如果 None，則使用全域預設值（請參閱 torch.set_default_dtype()）。

• layout (torch.layout, optional) – 傳回張量的所需佈局。預設值：torch.strided。

• device (torch.device, optional) – 傳回張量的所需裝置。預設值：如果 None，則使用預設張量類型的目前裝置（請參閱 torch.set_default_device()）。device 對於 CPU 張量類型將為 CPU，對於 CUDA 張量類型將為目前的 CUDA 裝置。

• requires_grad (bool, optional) – 如果 autograd 應該記錄對傳回張量的操作。預設值：False。

回傳類型

Tensor

範例

>>> # Generates a symmetric general cosine window with 3 coefficients.
>>> torch.signal.windows.general_cosine(10, a=[0.46, 0.23, 0.31], sym=True)
tensor([0.5400, 0.3376, 0.1288, 0.4200, 0.9136, 0.9136, 0.4200, 0.1288, 0.3376, 0.5400])

>>> # Generates a periodic general cosine window wit 2 coefficients.
>>> torch.signal.windows.general_cosine(10, a=[0.5, 1 - 0.5], sym=False)
tensor([0.0000, 0.0955, 0.3455, 0.6545, 0.9045, 1.0000, 0.9045, 0.6545, 0.3455, 0.0955])