\HeaderA{plot.wst2D}{Plot packet-ordered 2D non-decimated wavelet coefficients.}{plot.wst2D}
\keyword{hplot}{plot.wst2D}
\begin{Description}\relax
This function plots packet-ordered 2D non-decimated wavelet coefficients arising from a \code{\LinkA{wst2D}{wst2D}} object.
\end{Description}
\begin{Usage}
\begin{verbatim}
plot.wst2D(wst2D, plot.type="level", main="")
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{wst2D}] The \code{\LinkA{wst2D}{wst2D}} object whose coefficients you wish to plot.
\item[\code{plot.type}] So far the only valid argument is "level" which plots coefficients a level at a time.
\item[\code{main}] The main title of the plot.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The coefficients in a \code{\LinkA{wst2D}{wst2D}} object are stored in a three-dimensional subarray called \code{wst2D}. The first index of the 3D array indexes the resolution level of coefficients: this function with \code{plot.type="level"} causes an image of coefficients to be plotted one for each resolution level. 

The following corresponds to images produced on S+ graphics devices (e.g. image on \code{motif()}). Given a resolution level there are \code{4\textasciicircum{}(nlevels-level)} packets within a level. Each packet can be addressed by a base-4 string of length \code{nlevels-level}. A zero corresponds to no shift, a 1 to a horizontal shift, a 2 to a vertical shift and a 3 to both a horizontal and vertical shift. 

So, for example, at resolution level \code{nlevels-1} there are 4 sub-images each containing 4 sub-images. The main subimages correspond to (clockwise from bottom-left) no shift, horizontal shift, both shift and vertical shifts. The sub-images of the sub-images correspond to the usual smooth, horizontal detail, diagonal detail and vertical detail (clockwise, again from bottom left). Coarser resolution levels correspond to finer shifts! The following figure demonstrates the \code{nlevels-1} resolution level for the \code{ua} image (although the whole image has been rotated by 90 degrees clockwise for display here!):
\end{Details}
\begin{Value}
A plot of the coefficients contained within the \code{\LinkA{wst2D}{wst2D}} object is produced.
\end{Value}
\begin{Section}{RELEASE}
Version 3.9 Copyright Guy Nason 1998
\end{Section}
\begin{SeeAlso}\relax
\code{\LinkA{getpacket.wst2D}{getpacket.wst2D}}, \code{\LinkA{putpacket.wst2D}{putpacket.wst2D}}, \code{\LinkA{wst2D}{wst2D}}, \code{\LinkA{wst2D.object}{wst2D.object}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
#
# The above picture is one of a series produced by 
#
#plot(uawst2D)
#
# Where the uawst2D object was produced in the EXAMPLES section
# of the help for this-is-escaped-codenormal-bracket43bracket-normal
\end{ExampleCode}
\end{Examples}

