numpy.nansum

numpy.nansum(a, axis=None, dtype=None, out=None, keepdims=<class numpy._globals._NoValue at 0x40b6a26c>) [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-битная платформа. Введено в версии 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