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 не является допустимым массивом масок!

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

Примеры

>>> 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]