numpy.nansum

numpy.nansum(a, axis=None, dtype=None, out=None, keepdims=<class numpy._globals._NoValue>) [source]

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

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

Параметры:

a : array_like Массив, содержащий числа, сумма которых требуется. Если a не является массивом, попытка преобразования. axis : int, необязательно Ось, по которой вычисляется сумма. По умолчанию вычисляется сумма уплощенного массива. dtype : тип данных, необязательно Тип возвращаемого массива и аккумулятора, в котором суммируются элементы. По умолчанию используется тип данных a. Исключением является случай, когда a имеет целочисленный тип с меньшей точностью, чем платформа (u)intp. В этом случае по умолчанию будет либо (u)int32, либо (u)int64 в зависимости от того, 32 или 64 бита платформа. Для неточных входных данных dtype должен быть неточным. Новое в версии 1.8.0. out : ndarray, необязательно Альтернативный массив вывода, в который следует поместить результат. По умолчанию None. Если указан, он должен иметь ту же форму, что и ожидаемый результат, но тип будет преобразован при необходимости. См. doc.ufuncs для получения подробностей. Преобразование NaN в целое число может привести к неожиданным результатам. Новое в версии 1.8.0. keepdims : bool, необязательно Если установлено в 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