numpy.nansum

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

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

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

Параметры:

aarray_like

Массив, содержащий числа, сумма которых требуется. Если a не является массивом, производится попытка преобразования.

axis{int, tuple of int, None}, optional

Ось или оси, по которым вычисляется сумма. По умолчанию вычисляется сумма уплощенного массива.

dtypedata-type, optional

Тип возвращаемого массива и аккумулятора, в котором суммируются элементы. По умолчанию используется тип данных a. Исключением является случай, когда a имеет целочисленный тип с меньшей точностью, чем платформа (u)intp. В этом случае значение по умолчанию будет либо (u)int32, либо (u)int64, в зависимости от того, 32-битная или 64-битная платформа. Для приближенных входных данных dtype должен быть приближенным.

Добавлен в версии 1.8.0.

outndarray, optional

Альтернативный массив вывода, в который помещается результат. По умолчанию None. Если указан, он должен иметь ту же форму, что и ожидаемый результат, но тип будет преобразован при необходимости. См. Определение типа результата для получения дополнительной информации. Преобразование NaN в целое число может привести к неожиданным результатам.

Добавлен в версии 1.8.0.

keepdimsbool, optional

Если установлено в True, оси, которые были уменьшены, остаются в результате как измерения с размером один. С этим параметром результат будет правильно транслироваться относительно исходного a.

Если значение отличается от значения по умолчанию, то keepdims будет передано в методы mean или sum подклассов ndarray. Если методы подклассов не реализуют keepdims, будут вызваны исключения.

Добавлен в версии 1.8.0.

initialscalar, optional

Начальное значение для суммы. См. reduce для получения подробной информации.

Добавлен в версии 1.22.0.

wherearray_like of bool, optional

Элементы, которые следует включить в сумму. См. reduce для получения подробной информации.

Добавлен в версии 1.22.0.

Возвращаемое значение:

nansumndarray.

Возвращается новый массив, содержащий результат, если 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.inf])
-inf
>>> from numpy.testing import suppress_warnings
>>> with np.errstate(invalid="ignore"):
...     np.nansum([1, np.nan, np.inf, -np.inf]) # both +/- infinity present
np.float64(nan)