NAME

     mag_Matrix - calculate the magnitude of a matrix.

SYNOPSIS

      #include <math.h>
      #include "CVIPmatrix.h"

     Matrix *mag_Matrix(Matrix *in)

      <in> - input Matrix;

PATH

      $CVIPHOME/MatrixAlgebra/m_magnitude.c

DESCRIPTION

     This function calculates the magnitude of the passed  matrix
     structure and returns the result in a new Matrix structure.

TYPES AND CONSTANTS

     See libmatrix.3

RETURN VALUES

     Pointer to matrix structure containing themagnitude  of  the
     Matrix  at  each point.  This Matrix is REAL.  If the passed
     Matrix is REAL, it is left untouched.  Otherwise, the return
     matrix is of type CVIP_DOUBLE if the input Matrix is of type
     CVIP_DOUBLE, and of type CVIP_FLOAT otherwise.

HISTORY

     History information recorded: None

EXAMPLE


BUGS

     None at this time

SEE ALSO

     libmatrix, square_mag_Matrix()

AUTHOR

     Copyright (C) 1996 SIUE - by Scott Umbaugh and Arve Kjoelen