Update PoissonNLLLoss document. ;test=docs_preview (#5675)

* Update PoissonNLLoss document. ;test=docs_preview

* Update API label and fix parsing error

* Modify doc label of poisson_nll_loss

* Fix poisson_nll_loss issues

* Fix doc format errors

* Add support for float16 and bfloat16

Author: LyndonKong

docs/api/api_label

@@ -819,6 +819,7 @@ paddle.nn.LSTM	.. _api_paddle_nn_LSTM:
 paddle.nn.Pad1D	.. _api_paddle_nn_Pad1D:
 paddle.nn.Hardswish	.. _api_paddle_nn_Hardswish:
 paddle.nn.NLLLoss	.. _api_paddle_nn_NLLLoss:
+paddle.nn.PoissonNLLLoss	.. _api_paddle_nn_PoissonNLLLoss:
 paddle.nn.AlphaDropout	.. _api_paddle_nn_AlphaDropout:
 paddle.nn.LSTMCell	.. _api_paddle_nn_LSTMCell:
 paddle.nn.Pad3D	.. _api_paddle_nn_Pad3D:
@@ -977,6 +978,7 @@ paddle.nn.functional.relu6	.. _api_paddle_nn_functional_relu6:
 paddle.nn.functional.adaptive_avg_pool1d	.. _api_paddle_nn_functional_adaptive_avg_pool1d:
 paddle.nn.functional.prelu	.. _api_paddle_nn_functional_prelu:
 paddle.nn.functional.hardshrink	.. _api_paddle_nn_functional_hardshrink:
+paddle.nn.functional.poisson_nll_loss	.. _api_paddle_nn_functional_poisson_nll_loss:
 paddle.nn.functional.kl_div	.. _api_paddle_nn_functional_kl_div:
 paddle.nn.functional.relu_	.. _api_paddle_nn_functional_relu_:
 paddle.nn.functional.label_smooth	.. _api_paddle_nn_functional_label_smooth:

docs/api/paddle/nn/Overview_cn.rst

@@ -258,6 +258,7 @@ Loss 层
     " :ref:`paddle.nn.MarginRankingLoss <cn_api_nn_loss_MarginRankingLoss>` ", "MarginRankingLoss 层"
     " :ref:`paddle.nn.MSELoss <cn_api_paddle_nn_MSELoss>` ", "均方差误差损失层"
     " :ref:`paddle.nn.NLLLoss <cn_api_nn_loss_NLLLoss>` ", "NLLLoss 层"
+    " :ref:`paddle.nn.PoissonNLLLoss <cn_api_paddle_nn_PoissonNLLLoss>`", "PoissonNLLLoss 层"
     " :ref:`paddle.nn.SmoothL1Loss <cn_api_paddle_nn_SmoothL1Loss>` ", "平滑 L1 损失层"
     " :ref:`paddle.nn.SoftMarginLoss <cn_api_paddle_nn_SoftMarginLoss>` ", "SoftMarginLoss 层"
     " :ref:`paddle.nn.TripletMarginLoss <cn_api_paddle_nn_TripletMarginLoss>` ", "TripletMarginLoss 层"
@@ -476,6 +477,7 @@ Embedding 相关函数
     " :ref:`paddle.nn.functional.dice_loss <cn_api_fluid_layers_dice_loss>` ", "用于比较预测结果跟标签之间的相似度"
     " :ref:`paddle.nn.functional.hsigmoid_loss <cn_api_nn_functional_hsigmoid_loss>` ", "层次 sigmoid 损失函数"
     " :ref:`paddle.nn.functional.l1_loss <cn_paddle_nn_functional_loss_l1>` ", "用于计算 L1 损失"
+    " :ref:`paddle.nn.functional.poisson_nll_loss <cn_api_paddle_nn_functional_poisson_nll_loss>` ", "用于计算泊松分布的负对数似然损失"
     " :ref:`paddle.nn.functional.kl_div <cn_paddle_nn_functional_loss_kl_div>` ", "用于计算 KL 散度损失"
     " :ref:`paddle.nn.functional.log_loss <cn_api_fluid_layers_log_loss>` ", "用于计算负对数损失"
     " :ref:`paddle.nn.functional.margin_ranking_loss <cn_api_nn_cn_margin_ranking_loss>` ", "用于计算 margin rank loss 损失"

docs/api/paddle/nn/PoissonNLLLoss_cn.rst

@@ -0,0 +1,53 @@
+.. _cn_api_paddle_nn_PoissonNLLLoss:
+
+PoissonNLLLoss
+-------------------------------
+
+.. py:class:: paddle.nn.PoissonNLLLoss(log_input=False, full=False, eps=1e-8, reduction='mean', name=None)
+
+该接口可创建一个 PoissonNLLLoss 可调用类，计算输入 :attr:`input` 和标签 :attr:`label` 间的 `Poisson negative log likelihood loss` 损失。该 loss 适用于真实标签服从于泊松分布时，即
+
+.. math::
+    \text{label} \sim \mathrm{Poisson}(\text{input})
+
+该损失函数的数学计算公式如下：
+当 `log_input` 设置为 `True` 时，损失函数的数学计算公式为：
+
+.. math::
+    \text{loss}(\text{input}, \text{label}) = \text{input} - \text{label} * \log(\text{input}+\text{eps}) + \log(\text{label!})
+
+其中 `eps` 是 ``True`` 时使用的常数小量，使得 loss 计算过程中不会导致对 0 求对数情况的出现。
+当 `log_input` 设置为 `False` 时，损失函数的数学计算公式为：
+
+.. math::
+    \text{loss}(\text{input}, \text{label}) = \exp(\text{input}) - \text{label} * \text{input} + \log(\text{label!})
+
+损失函数中的最后一项可以使用 Stirling 公式近似，该近似项的计算公式为
+
+.. math::
+    \text{label} * \log(\text{label}) - \text{label} + 0.5 * \log(2 * \pi * \text{label})
+
+将 label 和每个元素都为 1 的同样形状的张量比较，对 label 值超过 1 的索引处考虑此项近似，对 label 的值小于等于 1 的索引处设置此项近似为 0 进行遮盖。
+
+参数
+:::::::::
+    - **log_input** (bool，可选) - 输入是否为对数函数映射后结果，默认值为 ``True``。
+    - **full** (bool，可选) - 是否在损失计算中包括 Stirling 近似项。默认值为 ``False``。
+    - **eps** (float，可选) - 在 :attr:`log_input` 为 ``True`` 时使用的常数小量。默认值为 1e-8。
+    - **reduction** (str，可选) - 指定应用于输出结果的计算方式，可选值有 ``none``、``mean`` 和 ``sum``。默认为 ``mean``，计算 ``mini-batch`` loss 均值。设置为 ``sum`` 时，计算 ``mini-batch`` loss 的总和。设置为 ``none`` 时，则返回 loss Tensor。默认值下为 ``mean``。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为 None。
+
+形状
+:::::::::
+    - **input** (Tensor) - 输入 `Tensor`，其形状为 :math:`[N, *]` ，其中 :math:`*` 表示任何数量的额外维度。数据类型为 float16， bfloat16， float32 或 float64。
+    - **label** (Tensor) - 标签 :attr:`Tensor`， 形状、数据类型和 :attr:`input` 相同。
+
+返回
+:::::::::
+
+    - **output** (Tensor) - 输入 `input` 和 `label` 间的 `Poisson negative log likelihood loss` 损失。如果 `reduction` 为 `'none'`，则输出 Loss 形状为 `[N, *]`。如果 `reduction` 为 `'sum'` 或者 `'mean'`，则输出 Loss 形状为 `'[1]'` 。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.nn.PoissonNLLLoss

docs/api/paddle/nn/functional/poisson_nll_loss_cn.rst

@@ -0,0 +1,44 @@
+.. _cn_api_paddle_nn_functional_poisson_nll_loss:
+
+poisson_nll_loss
+-------------------------------
+.. py:function:: paddle.nn.functional.poisson_nll_loss(input, label, log_input=False, full=False, eps=1e-8, reduction='mean', name=None)
+
+返回 `poisson negative log likelihood`。可在 :ref:`cn_api_paddle_nn_PoissonNLLLoss` 查看详情。
+
+参数
+:::::::::
+    - **input** (Tensor) - 输入 :attr:`Tensor`，对应泊松分布的期望，其形状为 :math:`[N, *]`，其中 :math:`*` 表示任何数量的额外维度。数据类型为 float16，bfloat16，float32 或 float64。
+    - **label** (Tensor) - 标签 :attr:`Tensor`， 形状、数据类型和 :attr:`input` 相同。
+    - **log_input** (bool，可选) - 输入是否为对数函数映射后结果，如果为 ``True``，则 loss 当中第一项的计算公式为
+
+    .. math::
+        \text{input} - \text{label} * \log(\text{input}+\text{eps})
+
+    其中 :attr:`eps` 为数值稳定使用的常数小量。
+    如果为 ``False``，则 loss 的计算公式为
+
+    .. math::
+        \exp(\text{input}) - \text{label} * \text{input}
+
+    默认值为 ``True``。
+
+    - **full** (bool，可选) - 是否在损失计算中包括 Stirling 近似项。该近似项的计算公式为
+
+    .. math::
+        \text{label} * \log(\text{label}) - \text{label} + 0.5 * \log(2 * \pi * \text{label})
+
+    默认值为 ``False``。
+
+    - **eps** (float，可选) - 在 :attr:`log_input` 为 ``True`` 时使用的常数小量，使得 loss 计算过程中不会导致对 0 求对数情况的出现。默认值为 1e-8。
+    - **reduction** (str，可选) - 指定应用于输出结果的计算方式，可选值有 ``none``、``mean`` 和 ``sum``。默认为 ``mean``，计算 ``mini-batch`` loss 均值。设置为 ``sum`` 时，计算 ``mini-batch`` loss 的总和。设置为 ``none`` 时，则返回 loss Tensor。默认值下为 ``mean``。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+:::::::::
+`Tensor`，返回存储表示 `poisson negative log likelihood loss` 的损失值。
+
+代码示例
+:::::::::
+
+COPY-FROM: paddle.nn.functional.poisson_nll_loss