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 бита на платформе. Для приближенных входных данных тип данных должен быть приближенным. Новая в версии 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