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

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.

Подробнее