numpy.ma.cumsum

numpy.ma.cumsum(self, axis=None, dtype=None, out=None) =

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

Маскированные значения устанавливаются в 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]