minval(3I)

NAME
     MINVAL - Returns the minimum value in an array

SYNOPSIS
     MINVAL ([ARRAY=]array [,[DIM=]dim] [,[MASK=]mask])

IMPLEMENTATION
     UNICOS, UNICOS/mk, IRIX systems

     CF90, MIPSpro 7 Fortran 90

STANDARDS
     Fortran

DESCRIPTION
     The MINVAL intrinsic function can be used for array reduction.  It
     returns the minimum value of the elements of array along dimension dim
     corresponding to the true elements of mask.  It accepts the following
     arguments:

     array     Must be of type integer or real.  It must not be scalar.

     dim       Must be a scalar integer value in the range 1 <= dim <= n,
               where n is the rank of array.  The corresponding actual
               argument must not be an optional dummy argument.

     mask      Must be of type logical and must be conformable with array.

     MINVAL is a transformational intrinsic function.  The name of this
     intrinsic cannot be passed as an argument.

NOTES
     On UNICOS systems, both execution speed and the number of bits used in
     mathematical operations are affected when compiling with
     f90 -O fastint, which is the default setting.  For more information,
     see CF90 Commands and Directives Reference Manual.

RETURN VALUES
     The result is of the same type as array.  It is scalar if dim is
     absent or array has rank one.  Otherwise, the result is an array of
     rank n-1 and of shape
     (d , d , ..., d     , d     , ..., d ),
       1   2        dim-1   dim+1        n
     where (d , d , ..., d )
             1   2        n
     is the shape of array.

     The result of MINVAL(array) has a value equal to the minimum value of
     all the elements of array or has the value of the positive number of
     the largest magnitude supported for numbers of the data type of array
     if array is a zero-sized array.

     The result of MINVAL(array,MASK=mask) has a value equal to the minimum
     value of all the elements of array corresponding to true elements of
     mask or has the value of the positive number of the largest magnitude
     supported for numbers of the data type of array if there are no true
     elements.

     If array has rank one, MINVAL(array,dim[,mask]) has a value equal to
     that of MINVAL(array[,MASK=mask]).  Otherwise, the value of element
     (s , s , ..., s     , s     , ..., s )
       1   2        dim-1   dim+1        n
     of MINVAL(array,dim[,mask]) is equal to
     MINVAL(array(s , s , ..., s     , : , s     , ..., s ),
                   1   2        dim-1       dim+1        n
      [, MASK=mask(s , s , ..., s     , : , s     , ..., s )]).
                    1   2        dim-1       dim+1        n

     On UNICOS and UNICOS/mk systems, MINVAL returns the value of
     +HUGE(array) for all zero-sized arrays.  On IRIX systems, MINVAL
     returns the value of +INFINITY for real, zero-sized arrays.  A request
     for interpretation of the Fortran 95 standard may change one of these
     return values for a real array in a future release.

EXAMPLES
     Example 1:  The value of MINVAL( (/ 1, 2, 3 /) ) is 1.

     Example 2:  Assume that C is the array [10,-100,10].  Then
     MINVAL(C, MASK=C .LT. 0) finds the minimum of the negative elements of
     C (which is -100) and MINVAL(C, MASK=C .GT. 10) returns the largest
     possible integer because there are no true elements using the mask.

     Example 3:  Assume that B is the following array:

        | 1 3 5 |

        | 2 4 6 |

     The following are true:

          MINVAL(B, DIM=1) is [1, 3, 5]

          MINVAL(B, DIM=2) is [1, 2]

          MINVAL(B) is 1

     Example 4:  Assume that N is the following array:

        | 0 1 2 3 |

        | 4 5 6 7 |

        | 8 9 0 1 |

     In an array section reference, the following are true:

          MINVAL(N(2:3,2:4),MASK=N(2:3,2:4).NE.0) is 1

          MINVAL(N(2:3,2:4),DIM=1,N(2:3,2:4).NE.0) is [5, 6, 1]

          MINVAL(N(2:3,2:4),DIM=2,N(2:3,2:4).NE.0) is [5, 1]

SEE ALSO
     Intrinsic Procedures Reference Manual for the printed version of this
     man page.