mindspore.ops.hann_window
==========================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/r2.3.q1/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindspore/blob/r2.3.q1/docs/api/api_python/ops/mindspore.ops.func_hann_window.rst
    :alt: 查看源文件


.. py:function:: mindspore.ops.hann_window(window_length, periodic=True, *, dtype=None)

    生成一个Hann window。

    Hann window定义：

    .. math::
        w(n) = \frac{1}{2} - \frac{1}{2} \cos\left(\frac{2\pi{n}}{M-1}\right),\qquad 0 \leq n \leq M-1

    参数：
        - **window_length** (int) - 输出window的大小。
        - **periodic** (bool, 可选) - 如果为 ``True`` ，则返回周期性window用于进行谱线分析。如果为 ``False`` ，则返回对称的window用于设计滤波器。默认值： ``True`` 。

    关键字参数：
        - **dtype** (mindspore.dtype, 可选) - 输出window的数据类型，必须为float。默认值： ``None`` 。
    
    返回：
        Tensor，一个Hann window。

    异常：
        - **TypeError** - 如果 `window_length` 不是整数。
        - **TypeError** - 如果 `periodic` 不是布尔类型。
        - **ValueError** - 如果 `window_length` 小于零。