\HeaderA{convert.wst}{Convert a non-decimated wst object into a wd object.}{convert.wst}
\keyword{manip}{convert.wst}
\begin{Description}\relax
Convert a packed-ordered non-decimated wavelet transform object into a time-ordered non-decimated wavelet transform object.
\end{Description}
\begin{Usage}
\begin{verbatim}
convert.wst(wst, ...) 
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{wst}] The \code{\LinkA{wst}{wst}} class object that you wish to convert.
\item[\code{...}] any other arguments
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
In WaveThresh3 a non-decimated wavelet transform can be ordered in two different ways: as a time-ordered or packet-ordered representation. The coefficients in the two objects are \emph{exactly the same} it is just their internal representation and ordering which is different. The two different representations are useful in different situations. The packet-ordering is useful for curve estimation applications and the time-ordering is useful for time series applications. 

See Nason, Sapatinas and Sawczenko, 1998 for further details on ordering and weaving. 

Note that the input object must be of the non-decimated type. In other words the type component of the input object must be "\code{station}". 
Once the input object has been converted the output can be used with any of the functions suitable for the \code{\LinkA{wd.object}{wd.object}}.

The actual weaving permutation for shuffling coefficients from one representation to another is achieved by the \code{\LinkA{getarrvec}{getarrvec}} function.
\end{Details}
\begin{Value}
An object of class \code{\LinkA{wd}{wd}} containing exactly the same information as the input object but ordered differently as a packet-ordered object.
\end{Value}
\begin{Section}{RELEASE}
Version 3.6 Copyright Guy Nason 1997
\end{Section}
\begin{SeeAlso}\relax
\code{\LinkA{convert}{convert}}, \code{\LinkA{getarrvec}{getarrvec}}, \code{\LinkA{wd}{wd}}, \code{\LinkA{wd.object}{wd.object}}, \code{\LinkA{wst}{wst}}, \code{\LinkA{wst.object}{wst.object}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
#
# Generate a sequence of 32 random normals (say) and take their
# this-is-escaped-code{
#
#myrand <- wst(rnorm(32))
#
# Print out the result (to verify the class and type of the object)
#
#myrand
#Class 'wst' : Stationary Wavelet Transform Object:
#       ~~~  : List with 8 components with names
#              wp Carray nlevels filter date 
#
#$WP and $Carray are the coefficient matrices

#
#Created on : Tue Sep 29 12:29:45 1998 
#
#summary(.):
#----------
#Levels:  5 
#Length of original:  32 
#Filter was:  Daub cmpct on least asymm N=10 
#Boundary handling:  periodic 

#Date:  Tue Sep 29 12:29:45 1998 
#
# Yep, the myrand object is of class: this-is-escaped-codenormal-bracket41bracket-normal.
#
# Now let's convert it to class this-is-escaped-codenormal-bracket43bracket-normal. The object
# gets returned and, as usual in S, is printed.
#
#convert(myrand)
#Class 'wd' : Discrete Wavelet Transform Object:
#       ~~  : List with 8 components with names
#              C D nlevels fl.dbase filter type bc date 
#
#$ C and $ D are LONG coefficient vectors !
#
#Created on : Tue Sep 29 12:29:45 1998 
#Type of decomposition:  station 
#
#summary(.):
#----------
#Levels:  5 
#Length of original:  32 
#Filter was:  Daub cmpct on least asymm N=10 
#Boundary handling:  periodic 
#Transform type:  station 
#Date:  Tue Sep 29 12:29:45 1998 
#
# The returned object is of class this-is-escaped-codenormal-bracket45bracket-normal with a
# type of "station".
# I.e. it has been converted successfully.
\end{ExampleCode}
\end{Examples}

