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

B = cumsum(A) возвращает совокупную сумму A запуск в начале первого измерения массива в A чей размер не равняется 1.

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

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

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

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

Примеры

Совокупная сумма вектора

Найдите совокупную сумму целых чисел от 1 к 5. Элемент B(2) сумма A(1) и A(2), в то время как B(5) сумма элементов A(1) через A(5).

A = 1:5;
B = cumsum(A)

B = 1×5

     1     3     6    10    15

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

Задайте 3х3 матрицу, элементы которой соответствуют своим линейным индексам.

A = [1 4 7; 2 5 8; 3 6 9]

A = 3×3

     1     4     7
     2     5     8
     3     6     9

Найдите совокупную сумму столбцов A. Элемент B(5) сумма A(4) и A(5), в то время как B(9) сумма A(7), A(8), и A(9).

B = cumsum(A)

B = 3×3

     1     4     7
     3     9    15
     6    15    24

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

Задайте 2 3 матрица, элементы которой соответствуют своим линейным индексам.

A = [1 3 5; 2 4 6]

A = 2×3

     1     3     5
     2     4     6

Найдите совокупную сумму строк A. Элемент B(3) сумма A(1) и A(3), в то время как B(5) сумма A(1), A(3), и A(5).

B = cumsum(A,2)

B = 2×3

     1     4     9
     2     6    12

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

Создайте массив логических значений.

A = [true false true; true true false]

A = 2x3 logical array

   1   0   1
   1   1   0

Найдите совокупную сумму строк A.

B = cumsum(A,2)

B = 2×3

     1     1     2
     1     2     2

Выход имеет, вводят double.

class(B)

ans = 
'double'

Противоположная совокупная сумма

Создайте 3х3 матрицу случайных целых чисел между 1 и 10.

rng default;
A = randi([1,10],3)

A = 3×3

     9    10     3
    10     7     6
     2     1    10

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

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

B = 3×3

    22    13     3
    23    13     6
    13    11    10

`Вектор с NaN` Значения

Создайте вектор, содержащий NaN значения и вычисляют совокупные суммы. По умолчанию, cumsum включает NaN значения. Когда вы включаете NaN значения в вычислении, совокупная сумма становится NaN как только первый NaN значение в A столкнут.

A = [3 5 NaN 9 0 NaN];
B = cumsum(A)

B = 1×6

     3     8   NaN   NaN   NaN   NaN

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

B = cumsum(A,'omitnan')

B = 1×6

     3     8     8    17    17    17

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

`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.

Класс B совпадает с классом A кроме если A islogical, в этом случае B double.

Больше о