mindspore.ops.hardshrink
========================

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


.. py:function:: mindspore.ops.hardshrink(x, lambd=0.5)

    Hard Shrink激活函数。按输入元素计算输出。公式定义如下:

    .. math::
        \text{HardShrink}(x) =
        \begin{cases}
        x, & \text{ if } x > \lambda \\
        x, & \text{ if } x < -\lambda \\
        0, & \text{ otherwise }
        \end{cases}

    HShrink函数图:

    .. image:: ../images/HShrink.png
        :align: center

    参数:
        - **x** (Tensor) - Hard Shrink的输入,数据类型为float16或float32。
        - **lambd** (float,可选) - Hard Shrink公式定义的阈值 :math:`\lambda` 。默认值: ``0.5`` 。

    返回:
        Tensor,shape和数据类型与输入 `x` 相同。

    异常:
        - **TypeError** - `lambd` 不是float。
        - **TypeError** - `x` 不是Tensor。
        - **TypeError** - `x` 的dtype既不是float16也不是float32。