numpy.ma.MaskedArray.sum

MaskedArray.sum(axis=None, dtype=None, out=None) [source]

Возвращает сумму элементов массива по заданной оси. Маскированные элементы внутренне устанавливаются в 0.

Параметры:

axis : {None, -1, int}, необязательно Ось, по которой вычисляется сумма. По умолчанию (axis = None) вычисляется по уплощенному массиву. dtype : {None, dtype}, необязательно Определяет тип возвращаемого массива и аккумулятора, где суммируются элементы. Если dtype имеет значение None, а тип a — целочисленный тип с точностью меньше, чем у платформенного целочисленного типа по умолчанию, то используется платформенная целочисленная точность по умолчанию. В противном случае, тип dtype совпадает с типом a. out : {None, ndarray}, необязательно Альтернативный массив вывода, в который помещается результат. Он должен иметь ту же форму и длину буфера, что и ожидаемый результат, но тип будет преобразован при необходимости.

Возвращает:

sum_along_axis : MaskedArray или скаляр Массив с той же формой, что и self, с удаленной указанной осью. Если self — массив размерности 0, или если axis равно None, возвращается скаляр. Если указан массив вывода, возвращается ссылка на out.

Примеры

>>> x = np.ma.array([[1,2,3],[4,5,6],[7,8,9]], mask=[0] + [1,0]*4)
>>> print(x)
[[1 -- 3]
 [-- 5 --]
 [7 -- 9]]
>>> print(x.sum())
25
>>> print(x.sum(axis=1))
[4 5 16]
>>> print(x.sum(axis=0))
[8 5 12]
>>> print(type(x.sum(axis=0, dtype=np.int64)[0]))
<type 'numpy.int64'>