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 или пустыми. В более поздних версиях возвращается ноль.

Параметры

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.

Возвращает

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.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