\section{FLIPDIM Reverse a Matrix Along a Given Dimension}

\subsection{USAGE}

Reverses an array along the given dimension.  The syntax for its use is
\begin{verbatim}
   y = flipdim(x,n)
\end{verbatim}
where \verb|x| is matrix, and \verb|n| is the dimension to reverse.
\subsection{Example}

The following examples show some uses of \verb|flipdim| on N-dimensional
arrays.
\begin{verbatim}
--> x = int32(rand(4,5,3)*10)

x = 

(:,:,1) = 

 8 0 2 6 6 
 2 0 6 9 5 
 4 5 6 2 9 
 5 3 8 1 6 

(:,:,2) = 

 7 7 4 2 4 
 5 8 5 3 1 
 2 2 7 9 9 
 6 0 7 0 2 

(:,:,3) = 

 3 2 0 7 1 
 4 6 0 6 3 
 5 2 1 7 2 
 6 2 6 7 1 

--> flipdim(x,1)

ans = 

(:,:,1) = 

 5 3 8 1 6 
 4 5 6 2 9 
 2 0 6 9 5 
 8 0 2 6 6 

(:,:,2) = 

 6 0 7 0 2 
 2 2 7 9 9 
 5 8 5 3 1 
 7 7 4 2 4 

(:,:,3) = 

 6 2 6 7 1 
 5 2 1 7 2 
 4 6 0 6 3 
 3 2 0 7 1 

--> flipdim(x,2)

ans = 

(:,:,1) = 

 6 6 2 0 8 
 5 9 6 0 2 
 9 2 6 5 4 
 6 1 8 3 5 

(:,:,2) = 

 4 2 4 7 7 
 1 3 5 8 5 
 9 9 7 2 2 
 2 0 7 0 6 

(:,:,3) = 

 1 7 0 2 3 
 3 6 0 6 4 
 2 7 1 2 5 
 1 7 6 2 6 

--> flipdim(x,3)

ans = 

(:,:,1) = 

 3 2 0 7 1 
 4 6 0 6 3 
 5 2 1 7 2 
 6 2 6 7 1 

(:,:,2) = 

 7 7 4 2 4 
 5 8 5 3 1 
 2 2 7 9 9 
 6 0 7 0 2 

(:,:,3) = 

 8 0 2 6 6 
 2 0 6 9 5 
 4 5 6 2 9 
 5 3 8 1 6 


\end{verbatim}
