\section{ANGLE Phase Angle Function
}

\subsection{Usage}

Compute the phase angle in radians of a complex matrix.  The general
syntax for its use is
\begin{verbatim}
  p = angle(c)
\end{verbatim}
where \verb|c| is an \verb|n|-dimensional array of numerical type.
\subsection{Function Internals}

For a complex number \verb|x|, its polar representation is
given by
\[
  x = |x| e^{j\theta}
\]
and we can compute 
\[
  \theta = \mathrm{atan2}(\Im x, \Re x)
\]
\subsection{Example}

Here are some examples of the use of \verb|angle| in the polar decomposition
of a complex number.
\begin{verbatim}
--> x = 3+4*i

x = 

    3.0000 +  4.0000i 

--> a = abs(x)

a = 

 5 

--> t = angle(x)

t = 

    0.9273 

--> a*exp(i*t)

ans = 

    3.0000 +  4.0000i 


\end{verbatim}
   M version contributor: M.W. Vogel 01-30-06
