cummax() - Signal Processing

M = cummax(A) returns
the cumulative maximum elements of A. By default, cummax(A) operates
along the first array dimension whose size does not equal 1.If A is a vector, then cummax(A) returns
a vector of the same size containing the cumulative maxima of A.If A is a matrix, then cummax(A) returns
a matrix of the same size containing the cumulative maxima in each
column of A.If A is a multidimensional array,
then cummax(A) returns an array of the same size
containing the cumulative maxima along the first array dimension of A whose
size does not equal 1.exampleM = cummax(A,dim) returns
the cumulative maxima along the dimension dim.
For example, if A is a matrix, then cummax(A,2) returns
the cumulative maxima along the rows of A.exampleM = cummax(___,direction) optionally
specifies the direction using any of the previous syntaxes. You must
specify A and, optionally, can specify dim.
For instance, cummax(A,2,'reverse') returns the
cumulative maxima of A by working from end to beginning
of the second dimension of A.

Syntax

M = cummax(A) exampleM = cummax(A,dim) exampleM = cummax(___,direction) example

Example

Cumulative Maximum Values in VectorOpen This Example
Find the cumulative maxima of a 1-by-10 vector of random integers.v = randi(10,1,10)

v =

     9    10     2    10     7     1     3     6    10    10

M = cummax(v)

M =

     9    10    10    10    10    10    10    10    10    10

Cumulative Maximum Values in Matrix ColumnsOpen This Example
Find the cumulative maxima of the columns of a 3-by-3 matrix.A = [3 5 2; 1 6 3; 7 8 1]

A =

     3     5     2
     1     6     3
     7     8     1

M = cummax(A)

M =

     3     5     2
     3     6     3
     7     8     3

Cumulative Maximum Values in Matrix RowsOpen This Example
Find the cumulative maxima of the rows of a 3-by-3 matrix.A = [3 5 2; 1 6 3; 7 8 1]

A =

     3     5     2
     1     6     3
     7     8     1

M = cummax(A,2)

M =

     3     5     5
     1     6     6
     7     8     8

Cumulative Maximum Array Values in Reverse DirectionOpen This Example
Calculate the cumulative maxima in the third dimension of a 2-by-2-by-3 array. Specify direction as 'reverse' to work from the end of the third dimension to the beginning.A = cat(3,[1 2; 3 4],[9 10; 11 12],[5 6; 7 8])

A(:,:,1) =

     1     2
     3     4


A(:,:,2) =

     9    10
    11    12


A(:,:,3) =

     5     6
     7     8

M = cummax(A,3,'reverse')

M(:,:,1) =

     9    10
    11    12


M(:,:,2) =

     9    10
    11    12


M(:,:,3) =

     5     6
     7     8

Output / Return Value

Limitations

Alternatives / See Also

Reference