min
===

minimum



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


::

    [m [,k]]=min(A)
    [m [,k]]=min(A,'c')
    [m [,k]]=min(A,'r')
    [m [,k]]=min(A,'m')
    [m [,k]]=min(A1,A2,...,An)
    [m [,k]]=min(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, `min(A)` is the least element `A`.
`[m,k]=min(A)` gives in addition the index of the minimum. 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 minimum of the
`j`th column of `A` ( `A(:,j)`), `k(j)` gives the row indice which
contain the minimum for column `j`. `'c'` is used for the dual
operation on the rows of `A`. `'m'` is used for compatibility with
Matlab.

`m=min(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)= min( Aj(i)), j=1,...,n`. `[m,k]=min(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 minimum.

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



Examples
~~~~~~~~


::

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




See Also
~~~~~~~~


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


.. _max: max.html
.. _gsort: gsort.html
.. _find: find.html