numpy.ma.MaskedArray.cumsum

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

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

Маскированные значения устанавливаются в 0 во время вычисления. Однако их положение сохраняется, и результат будет маскирован в тех же местах.

Параметры:

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

Возвращает:

cumsum : ndarray. Возвращается новый массив, содержащий результат, если out не указан, в противном случае возвращается ссылка на out.

Примечания

Маска теряется, если out не является допустимым MaskedArray !

Арифметика является модульной при использовании целочисленных типов, и ошибка не возникает при переполнении.

Примеры

>>> marr = np.ma.array(np.arange(10), mask=[0,0,0,1,1,1,0,0,0,0])
>>> print(marr.cumsum())
[0 1 3 -- -- -- 9 16 24 33]