cumsum

Soma cumulativa dos elementos de um array.

Categoria: Language Fundamentals > Operators and Elementary Operations

Sintaxe

B = cumsum(A)

B = cumsum(A, dim)

Descrição

O elemento k de cumsum(x) é sum(x(1:k)). É o análogo discreto da integração e a inversa de diff a menos do primeiro valor: cumsum(diff(x)) é igual a x(2:end) - x(1).

Para uma matriz as somas correm pelas colunas; use cumsum(A, 2) para correr pelas linhas. Tipos inteiros saturam nos limites, e a entrada lógica é convertida para double.

Argumentos de entrada

A

Array numérico ou lógico.

dim

Dimensão ao longo da qual acumular.

Argumentos de saída

B

Array do mesmo tamanho de A; o elemento k é a soma dos k primeiros elementos.

Exemplo

cumsum(1:5)
A = [1 2; 3 4];
cumsum(A)
cumsum(A, 2)
cumsum(int8([100 100]))

ans = 1×5

     1     3     6    10    15
ans = 2×2

     1     2
     4     6
ans = 2×2

     1     3
     3     7
ans = 1×2 int8 row vector

   100   127

Veja também

cumprod sum diff movsum