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

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 значения являются суммой всего non-NaN элементы. Если всеми элементами является NaN, затем cumsum возвращается 0.

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

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

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

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

Больше о