mindspore.ops.bartlett_window

mindspore.ops.bartlett_window(window_length, periodic=True, *, dtype=None)[源代码]

Bartlett窗口函数是一种三角形状的加权函数,通常用于平滑处理或频域分析信号。

window_length 是一个Tensor,控制返回的窗口大小,其数据类型必须是整数。特别的,当 window_length 为1时,返回的窗口只包含一个值,为 1periodic 决定返回的窗口是否会删除对称窗口的最后一个重复值,并准备用作带函数的周期窗口。因此,如果 periodic 为True, \(N\)\(window\_length + 1\)

\[\begin{split}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},\end{split}\]

其中,N是总的窗口长度 window_length

参数:
  • window_length (Tensor) - 返回窗口的大小,数据类型为int32,int64。输入数据的值为[0, 1000000]的整数。

  • periodic (bool,可选) - 决定返回的窗口作为周期函数还是对称窗口。默认值:True。

关键字参数:
  • dtype (mindspore.dtype,可选) - 输出数据类型,目前只支持float16、float32和float64。默认值:None。

返回:

1D Tensor,大小为 window_length ,数据类型与 dtype 一致。如果 dtype 为None,则数据类型为float32。

异常:
  • TypeError - window_length 不是Tensor。

  • TypeError - window_length 的数据类型不是int32、int64。

  • TypeError - periodic 不是bool。

  • TypeError - dtype 不是float16、float32、float64。

  • ValueError - window_length 的值不在[0, 1000000]。

  • ValueError - window_length 的维度不等于0。

支持平台:

Ascend GPU CPU

样例:

>>> window_length = Tensor(5, mstype.int32)
>>> output = ops.bartlett_window(window_length, periodic=True, dtype=mstype.float32)
>>> print(output)
[0. 0.4 0.8 0.8 0.4]