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

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.

Подробнее