\Header{splice}{Splice Time Series}
\methalias{splice.default}{splice}
\keyword{programming}{splice}
\keyword{utilities}{splice}
\keyword{ts}{splice}
\begin{Description}\relax
Splice together (in time dimension) two time series objects. This function can also be 
used to overlay obj1 on obj2 (obj1 takes precedence). The time windows do
not have to correspond.
\end{Description}
\begin{Usage}
\begin{verbatim}
    splice(mat1,mat2, ...)
    ## Default S3 method:
    splice(mat1,mat2, ...)
    \end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{mat1}] A time series object.
\item[\code{mat2}] A time series object.
\item[\code{...}] arguments to be passed to other methods (not used by the default
method).
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Splice together two time series objects. The mat1 and mat2 objects should contain the 
same number of time series variables and be arranged in the same order.
(e.g. - the first column of mat1 is spliced to the first column of 
mat2, etc.).
If data  is provided in both mat1 and mat2 for a given period then mat1 takes 
priority. The frequencies should be the same.
\end{Details}
\begin{Value}
A time series object\end{Value}
\begin{SeeAlso}\relax
\code{\Link{tfwindow}},
\code{\Link{trimNA}},
\code{\Link{tbind}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
splice(ts(matrix(rnorm(24),24,1), start=c(1980,1), frequency=4),
       ts(matrix(rnorm(6),  6,1), start=c(1986,1), frequency=4))
\end{ExampleCode}
\end{Examples}

