numpy.nansum #

麻木的。nansum ( a , axis=None , dtype=None , out=None , keepdims=<无 值> , initial=<无 值> , where=<无 值> ) [来源] #

返回给定轴上数组元素的总和,将非数字 (NaN) 视为零。

在 NumPy 版本 <= 1.9.0 中,对于全 NaN 或空的切片返回 Nan。在更高版本中返回零。

参数
类似数组

包含所需总和的数字的数组。如果a不是数组,则尝试转换。

axis {int, int 元组, None}, 可选

计算总和所沿的一个或多个轴。默认值是计算展平数组的总和。

dtype数据类型,可选

返回的数组以及对元素进行求和的累加器的类型。默认情况下,使用a的数据类型。例外情况是a的整数类型精度低于平台 (u)intp。在这种情况下,默认值为 (u)int32 或 (u)int64,具体取决于平台是 32 位还是 64 位。对于不精确的输入,dtype 必须不精确。

1.8.0 版本中的新增功能。

输出ndarray,可选

用于放置结果的备用输出数组。默认为None.如果提供,它必须具有与预期输出相同的形状,但如果需要,类型将被转换。有关更多详细信息,请参阅 输出类型确定。将 NaN 转换为整数可能会产生意想不到的结果。

1.8.0 版本中的新增功能。

keepdims布尔值,可选

如果将此设置为 True,则缩小的轴将作为大小为 1 的维度保留在结果中。使用此选项,结果将根据原始a正确广播。

如果该值不是默认值,则 keepdims将传递给的子类的mean或方法。如果子类方法没有实现keepdims,则会引发任何异常。sumndarray

1.8.0 版本中的新增功能。

初始标量,可选

总和的起始值。reduce详情请参阅。

1.22.0 版本中的新增功能。

其中array_like of bool,可选

要包含在总和中的元素。reduce详情请参阅。

1.22.0 版本中的新增功能。

返回
南苏姆ndarray。

除非指定了返回结果的out ,否则将返回保存结果的新数组。如果axis不是 None 或a是一维数组,结果的大小与a相同,并且形状与a相同。

也可以看看

numpy.sum

跨数组传播 NaN 求和。

isnan

显示哪些元素是 NaN。

isfinite

显示哪些元素不是 NaN 或 +/-inf。

笔记

如果正无穷大和负无穷大同时存在,则总和将为非数字 (NaN)。

例子

>>> np.nansum(1)
1
>>> np.nansum([1])
1
>>> np.nansum([1, np.nan])
1.0
>>> a = np.array([[1, 1], [1, np.nan]])
>>> np.nansum(a)
3.0
>>> np.nansum(a, axis=0)
array([2.,  1.])
>>> np.nansum([1, np.nan, np.inf])
inf
>>> np.nansum([1, np.nan, np.NINF])
-inf
>>> from numpy.testing import suppress_warnings
>>> with suppress_warnings() as sup:
...     sup.filter(RuntimeWarning)
...     np.nansum([1, np.nan, np.inf, -np.inf]) # both +/- infinity present
nan