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,则会引发任何异常。sum
ndarray
1.8.0 版本中的新增功能。
- 初始标量,可选
总和的起始值。
reduce
详情请参阅。1.22.0 版本中的新增功能。
- 其中array_like of bool,可选
要包含在总和中的元素。
reduce
详情请参阅。1.22.0 版本中的新增功能。
- 返回:
- 南苏姆ndarray。
除非指定了返回结果的out ,否则将返回保存结果的新数组。如果axis不是 None 或a是一维数组,结果的大小与a相同,并且形状与a相同。
笔记
如果正无穷大和负无穷大同时存在,则总和将为非数字 (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