max
===

maximum



Calling Sequence
~~~~~~~~~~~~~~~~


::

    [m [,k]]=max(A)
    [m [,k]]=max(A,'c')
    [m [,k]]=max(A,'r')
    [m [,k]]=max(A,'m')
    [m [,k]]=max(A1,A2,...,An)
    [m [,k]]=max(list(A1,A2,...,An))




Arguments
~~~~~~~~~

:A real vector or matrix
: :A1,...,An a set of real vectors or matrices, all of the same size
  or scalar
:



Description
~~~~~~~~~~~

For `A`, a real vector or matrix, `max(A)` is the largest element `A`.
`[m,k]=max(A)` gives in addition the index of the maximum. A second
argument of type string `'r'` or `'c'` can be used : `'r'` is used to
get a row vector `m` such that `m(j)` contains the maximum of the
`j`th column of `A` ( `A(:,j)`), `k(j)` gives the row indice which
contain the maximum for column `j`. `'c'` is used for the dual
operation on the rows of `A`. `'m'` is used for compatibility with
Matlab.

`m=max(A1,A2,...,An)`, where all the `Aj` are matrices of the same
sizes, returns a vector or a matrix `m` of size `size(m)=size(A1)`
such that `m(i)= max( Aj(i)), j=1,...,n`. `[m,k]=max(A1,A2,...,An)`
gives in addition the vector or matrix `k`. For a fixed `i`, `k(i)` is
the number of the first `Aj(i)` achieving the maximum.

`[m,k]=max(list(A1,...,An))` is an equivalent syntax of
`[m,k]=max(A1,A2,...,An)`.



Examples
~~~~~~~~


::

    [m,n]=max([1,3,1])
    [m,n]=max([3,1,1],[1,3,1],[1,1,3])
    [m,n]=max([3,-2,1],1)
    [m,n]=max(`list`_([3,1,1],[1,3,1],[1,1,3]))
    [m,n]=max(`list`_(1,3,1))




See Also
~~~~~~~~


+ `gsort`_ sorting by quick sort agorithm
+ `find`_ find indices of boolean vector or matrix true elements
+ `min`_ minimum


.. _min: min.html
.. _gsort: gsort.html
.. _find: find.html