\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 = 
  <dcomplex>  - size: [1 1]
  3+ 4i  
--> a = abs(x)
a = 
  <double>  - size: [1 1]
 5  
--> t = angle(x)
t = 
  <double>  - size: [1 1]
 0.9272952180016122  
--> a*exp(i*t)
ans = 
  <dcomplex>  - size: [1 1]
 3.0000000000000004+3.9999999999999996i  

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