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

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 является logical, в этом случае B является double.

Больше о