## 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