`cummax`

Máximo acumulado: maior valor até cada posição ao longo de um array.

Categoria: Data Import and Analysis > Descriptive Statistics

Sintaxe

M = cummax(A)

Máximo acumulado ao longo da primeira dimensão de tamanho diferente de 1.

M = cummax(A, dim)

Ao longo da dimensão dim.

Descrição

O resultado nunca diminui. É útil para acompanhar o melhor valor até o momento, uma marca d'água máxima, ou quedas em uma série (compare os dados com o máximo acumulado).

Para uma matriz, cummax(A) atua em cada coluna e cummax(A, 2) em cada linha.

Argumentos de entrada

A: Array numérico.
dim: Dimensão em que operar.

Argumentos de saída

M: Array do mesmo tamanho de A; M(k) é o maior dos primeiros k elementos.

Exemplo

Máximo acumulado

x = [1 3 2 5 4];
cummax(x)
A = [1 5; 3 2; 4 9];
cummax(A, 2)

Saída

ans = 1×5

     1     3     3     5     5
ans = 3×2

     1     5
     3     3
     4     9

Veja também

cummin cumsum max movmax