numpy.nansum

numpy.nansum(a, axis=None, dtype=None, out=None, keepdims=<no value>) [source]

Возвращает сумму элементов массива по заданной оси, рассматривая значения Not a Number (NaN) как ноль.

В версиях NumPy <= 1.9.0 Nan возвращается для срезов, которые содержат только NaN или пустые. В более поздних версиях возвращается ноль.

Параметры:

a : array_like Массив, содержащий числа, сумма которых требуется. Если a не является массивом, производится попытка преобразования. axis : {int, tuple of int, None}, optional Ось или оси, по которым вычисляется сумма. По умолчанию вычисляется сумма сплющенного массива. dtype : data-type, optional Тип возвращаемого массива и аккумулятора, в котором суммируются элементы. По умолчанию используется тип данных a. Исключением является случай, когда a имеет целочисленный тип с меньшей точностью, чем платформа (u)intp. В этом случае по умолчанию будет либо (u)int32, либо (u)int64 в зависимости от того, 32-битная или 64-битная платформа. Новое в версии 1.8.0. out : ndarray, optional Альтернативный выходной массив, в который следует поместить результат. По умолчанию это None. Если указан, он должен иметь такую же форму, как ожидаемый результат, но тип будет преобразован при необходимости. См. doc.ufuncs для получения подробностей. Преобразование NaN в целые числа может привести к неожиданным результатам. Новое в версии 1.8.0. keepdims : bool, optional Если это значение установлено в True, оси, которые были уменьшены, остаются в результате как размерности с размером один. С этим вариантом результат будет корректно транслироваться по отношению к исходному a. Если значение отличается от значения по умолчанию, тогда keepdims будет передано в методы mean или sum подклассов ndarray. Если методы подклассов не реализуют keepdims, будут вызваны исключения. Новое в версии 1.8.0.

Возвращает:

nansum : ndarray. Возвращается новый массив, содержащий результат, если не указан out, в этом случае он возвращается. Результат имеет такой же размер, как a, и такую же форму, как a, если axis не равно None или a является одномерным массивом.

См. также

numpy.sum

Сумма по массиву с распространением NaN.

isnan

Показывает, какие элементы являются NaN.

isfinite

Показывает, какие элементы не NaN или +/-inf.

Примечания

Если присутствуют как положительная, так и отрицательная бесконечность, сумма будет Not A Number (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
>>> np.nansum([1, np.nan, np.inf, -np.inf]) # both +/- infinity present
nan