

    \filetitle{plotmat}{Visualise 2D matrix}{grfun/plotmat}

	\paragraph{Syntax}
 
 \begin{verbatim}
 [POSH,NEGH,NANINFH,MAXH] = grfun.plotmat(X,...)
 \end{verbatim}
 \paragraph{Short-cut syntax}
 
 \begin{verbatim}
 [POSH,NEGH,NANINFH,MAXH] = plotmat(X,...)
 \end{verbatim}
 \paragraph{Input arguments}
 
 \begin{itemize}
 \item
   \texttt{X} {[} numeric {]} - 2D matrix that will be visualised; ND
   matrices will be unfolded in 2nd dimension before plotting.
 \end{itemize}
 \paragraph{Output arguments}
 
 \begin{itemize}
 \item
   \texttt{POSH} {[} numeric {]} - Handles to discs displaying
   non-negative entries.
 \item
   \texttt{NEGH} {[} numeric {]} - Handles to discs displeying negative
   entries.
 \item
   \texttt{NANINFH} {[} numeric {]} - Handles to NaN or Inf marks.
 \item
   \texttt{MAXH} {[} numeric {]} - Handles to circles displaying maximum
   value.
 \end{itemize}
 \paragraph{Options}
 
 \begin{itemize}
 \item
   \texttt{'colNames='} {[} char \textbar{} cellstr \textbar{}
   \emph{empty} {]} - Names that will be given to the columns of the
   matrix.
 \item
   \texttt{'rowNames='} {[} char \textbar{} cellstr \textbar{}
   \emph{empty} {]} - Names that will be give to the row of the matrix.
 \item
   \texttt{'maxCircle='} {[} \texttt{true} \textbar{}
   \emph{\texttt{false}} {]} - Displey a circle denoting the maximum
   value around each entry.
 \item
   \texttt{'scale='} {[} numeric \textbar{} \emph{\texttt{'auto'}} {]} -
   Maximum value (positive) relative to which all matrix entries will be
   scaled; by default the scale is the maximum entry in the input matrix,
   \texttt{max(max(abs(X(isfinite(X))))}.
 \end{itemize}
 \paragraph{Description}
 
 \paragraph{Example}


