

    \filetitle{spy}{Visualise tseries observations that pass a test}{tseries/spy}

	\paragraph{Syntax}
 
 \begin{verbatim}
 [AA,LL] = spy(X,...)
 [AA,LL] = spy(RANGE,X,...)
 \end{verbatim}
 \paragraph{Input arguments}
 
 \begin{itemize}
 \item
   \texttt{X} {[} tseries {]} - Input tseries object whose non-NaN
   observations will be plotted as markers.
 \item
   \texttt{RANGE} {[} tseries {]} - Date range on which the tseries
   observations will be visualised; if not specified the entire available
   range will be used.
 \end{itemize}
 \paragraph{Output arguments}
 
 \begin{itemize}
 \item
   \texttt{AA} {[} tseries {]} - Handle to the axes created.
 \item
   \texttt{LL} {[} tseries {]} - Handle to the marks plotted.
 \end{itemize}
 \paragraph{Options}
 
 \begin{itemize}
 \item
   \texttt{'dateformat='} {[} char \textbar{}
   \emph{irisget(`plotdateformat')} {]} - Date format for the tick marks
   on the x-axis.
 \item
   \texttt{'datetick='} {[} numeric \textbar{} \emph{\texttt{Inf}} {]} -
   Vector of dates locating tick marks on the x-axis; Inf means they will
   be created automatically.
 \item
   \texttt{'names='} {[} cellstr {]} - Names that will be used to
   annotate individual columns of the input tseries object.
 \item
   \texttt{'test='} {[} function\_handle \textbar{}
   \emph{@(x)\ensuremath{\sim}isnan(x)} {]} - Test applied to each
   observations; only the values returning a true will be displayed.
 \end{itemize}
 \paragraph{Description}
 
 \paragraph{Example}


