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

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

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

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

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

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

Класс B совпадает с классом A кроме тех случаев, когда A является logical, в каком случае B является double.

Подробнее о