.. _cn_api_paddle_nansum:

nansum
-------------------------------

.. py:function:: paddle.nansum(x, axis=None, dtype=None, keepdim=False, name=None)

计算给定轴上的元素之和，并将非数字元素（NaNs）视为 0。

参数
:::::::::
    - **x** (Tensor) - 输入的 Tensor，数据类型为：bfloat16、float16、float32、float64、int32 或 int64。
    - **axis** (int|list|tuple，可选) - 求和运算的维度。如果为 None，则计算所有元素的和并返回包含单个元素的 Tensor 变量，否则必须在 :math:`[−rank(x),rank(x)]` 范围内。如果 :math:`axis [i] <0`，则维度将变为 :math:`rank+axis[i]`，默认值为 None。
    - **dtype** (str|paddle.dtype|np.dtype，可选) - 输出变量的数据类型。若参数为空，则输出变量的数据类型和输入变量相同，默认值为 None。
    - **keepdim** (bool) - 是否在输出 Tensor 中保留减小的维度。如 keepdim 为 True，否则结果 Tensor 的维度将比输入 Tensor 小，默认值为 False。
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

返回
:::::::::
``Tensor``，在指定维度上进行求和运算的 Tensor，数据类型和输入数据类型一致。

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

COPY-FROM: paddle.nansum
