Документация

B = cumsum(A) возвращает совокупную сумму A начиная с начала измерения массива в A чей размер не равен 1. Область выхода B имеет тот же размер, что и A.

Если A является вектором, тогда cumsum(A) возвращает вектор, содержащий совокупную сумму элементов A.
Если A является матрицей, тогда cumsum(A) возвращает матрицу, содержащую совокупные суммы каждого столбца A.
Если A является многомерным массивом, затем cumsum(A) действует по первому несинглтону размерности.

B = cumsum(A,dim) возвращает совокупную сумму по размерности dim. Для примера, если A является матрицей, тогда cumsum(A,2) возвращает совокупную сумму каждой строки.

B = cumsum(___,direction) задает направление с помощью любого из предыдущих синтаксисов. Для образца, cumsum(A,2,'reverse') возвращает совокупную сумму в строках A путем работы от конца до начала второго измерения.

B = cumsum(___,nanflag) определяет, включать или опускать NaN значения из вычисления для любого из предыдущих синтаксисов. cumsum(A,'includenan') включает все NaN значения в вычислении при cumsum(A,'omitnan') игнорирует их.

Примеры

Совокупная сумма символьного вектора

Создайте символьный вектор. Найдите совокупную сумму его элементов.

syms x
A = (1:5)*x

A =  $(\begin{array}{c} x & 2 x & 3 x & 4 x & 5 x \end{array})$

В векторе совокупных сумм, элементарные B(2) - сумма A(1) и A(2), в то время как B(5) - сумма элементов A(1) через A(5).

B = cumsum(A)

B =  $(\begin{array}{c} x & 3 x & 6 x & 10 x & 15 x \end{array})$

Совокупная сумма каждого столбца и строки в символьной матрице

Создайте символьную матрицу 3 на 3 A элементы которого все равны 1.

A = sym(ones(3))

A = 
 $(\begin{array}{c} 1 & 1 & 1 \\ 1 & 1 & 1 \\ 1 & 1 & 1 \end{array})$

Вычислите совокупную сумму элементов A. По умолчанию cumsum возвращает совокупную сумму каждого столбца.

B = cumsum(A)

B = 
 $(\begin{array}{c} 1 & 1 & 1 \\ 2 & 2 & 2 \\ 3 & 3 & 3 \end{array})$

Чтобы вычислить совокупную сумму каждой строки, установите значение dim опция для 2.

B = cumsum(A,2)

B = 
 $(\begin{array}{c} 1 & 2 & 3 \\ 1 & 2 & 3 \\ 1 & 2 & 3 \end{array})$

Обратная совокупная сумма 3-D символьного массива

Создайте символьный массив 3 на 3 на 2.

syms x y
A(:,:,1) = [x y 3; 3 x y; y 2 x];
A(:,:,2) = [x y 1/3; 1 y x; 1/3 x 2];
A

A(:,:,1) = 
 $(\begin{array}{c} x & y & 3 \\ 3 & x & y \\ y & 2 & x \end{array})$

A(:,:,2) = 
 $(\begin{array}{c} x & y & \frac{1}{3} \\ 1 & y & x \\ \frac{1}{3} & x & 2 \end{array})$

Вычислите совокупную сумму по строкам путем определения dim как 2. Задайте 'reverse' опция работы справа налево в каждой строке. Результатом является тот же размер, что и A.

B = cumsum(A,2,'reverse')

B(:,:,1) = 
 $(\begin{array}{c} x + y + 3 & y + 3 & 3 \\ x + y + 3 & x + y & y \\ x + y + 2 & x + 2 & x \end{array})$

B(:,:,2) = 
 $(\begin{array}{c} x + y + \frac{1}{3} & y + \frac{1}{3} & \frac{1}{3} \\ x + y + 1 & x + y & x \\ x + \frac{7}{3} & x + 2 & 2 \end{array})$

Чтобы вычислить совокупную сумму по третьей (страничной) размерности, задайте dim как 3. Задайте 'reverse' опция работы с самым большим индексом страницы до самым маленьким индексом страницы.

B = cumsum(A,3,'reverse')

B(:,:,1) = 
 $(\begin{array}{c} 2 x & 2 y & \frac{10}{3} \\ 4 & x + y & x + y \\ y + \frac{1}{3} & x + 2 & x + 2 \end{array})$

B(:,:,2) = 
 $(\begin{array}{c} x & y & \frac{1}{3} \\ 1 & y & x \\ \frac{1}{3} & x & 2 \end{array})$

Символьный вектор с `NaN` Значения

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

A = [sym('a') sym('b') 1 NaN 2]

A =  $(\begin{array}{c} a & b & 1 & NaN & 2 \end{array})$

B = cumsum(A)

B =  $(\begin{array}{c} a & a + b & a + b + 1 & NaN & NaN \end{array})$

Можно игнорировать NaN значения в вычислении совокупной суммы с помощью 'omitnan' опция.

B = cumsum(A,'omitnan')

B =  $(\begin{array}{c} a & a + b & a + b + 1 & a + b + 1 & a + b + 3 \end{array})$

Входные параметры

`A` - Входной массив
символьный вектор | символьная матрица | символьный многомерный массив

Входной массив, заданный как символьный вектор, матрица или многомерный массив.

`dim` - Размерность для работы
положительный целочисленный скаляр

Размерность для работы, заданная как положительный целочисленный скаляр Если значение не задано, то по умолчанию это первое измерение массива, не равный 1.

Рассмотрим двумерный входной массив, A:

cumsum(A,1) работает над последовательными элементами в столбцах A и возвращает совокупную сумму каждого столбца.
cumsum(A,2) работает над последовательными элементами в строках A и возвращает совокупную сумму каждой строки.

cumsum возвращает A если dim больше ndims(A).

`direction` - Направление кумуляции
`'forward'` (по умолчанию) | `'reverse'`

Направление кумуляции, заданное как 'forward' (по умолчанию) или 'reverse'.

'forward' работает от 1 на end активной размерности.
'reverse' работает от end на 1 активной размерности.

Типы данных: char

`nanflag` — `NaN` состояние
`'includenan'` (по умолчанию) | `'omitnan'`

NaN условие, заданное как:

'includenan' - Включить NaN значения от входов при вычислении совокупных сумм, что приводит к NaN значений в выходах.
'omitnan' - Игнорировать все NaN значений во входе. Сумма элементов, содержащих NaN значения являются суммой всех не- NaN элементы. Если все элементы NaN, затем cumsum возвращает 0.

Типы данных: char

Выходные аргументы

`B` - Совокупный суммарный массив
вектор | матрица | многомерный массив

Совокупный суммарный массив, возвращенный в виде вектора, матрицы или многомерного массива того же размера, что и входной A.

Подробнее о