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]