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

Параметры:

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