.. _cn_api_nn_Hardtanh:

Hardtanh
-------------------------------
.. py:class:: paddle.nn.Hardtanh(min=-1.0, max=1.0, name=None)

Hardtanh激活层（Hardtanh Activation Operator）。计算公式如下：

.. math::

    Hardtanh(x)=
        \left\{
        \begin{aligned}
        &max, & & if \ x > max \\
        &min, & & if \ x < min \\
        &x, & & if \ others
        \end{aligned}
        \right.

其中，:math:`x` 为输入的 Tensor

参数
::::::::::
    - min (float, 可选) - Hardtanh激活计算公式中的min值。默认值为-1。
    - max (float, 可选) - Hardtanh激活计算公式中的max值。默认值为1。
    - name (str, 可选) - 操作的名称(可选，默认值为None）。更多信息请参见 :ref:`api_guide_Name`。

形状:
::::::::::
    - input: 任意形状的Tensor。
    - output: 和input具有相同形状的Tensor。

代码示例
:::::::::

.. code-block:: python

    import paddle
    import numpy as np

    paddle.disable_static()

    x = paddle.to_tensor(np.array([-1.5, 0.3, 2.5]))
    m = paddle.nn.Hardtanh()
    out = m(x) # # [-1., 0.3, 1.]
