\HeaderA{smooth.construct.tensor.smooth.spec}{Tensor product smoothing constructor}{smooth.construct.tensor.smooth.spec}
\keyword{models}{smooth.construct.tensor.smooth.spec}
\keyword{regression}{smooth.construct.tensor.smooth.spec}
\begin{Description}\relax
A special \code{smooth.construct} method function for creating tensor product smooths from any
combination of single penalty marginal smooths.
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'tensor.smooth.spec':
smooth.construct(object, data, knots)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] a smooth specification object of class \code{tensor.smooth.spec}, 
usually generated by a term like \code{te(x,z)} in a \code{\LinkA{gam}{gam}} model formula
\item[\code{data}] a list containing just the data (including any \code{by} variable) required by this term, 
with names corresponding to \code{object\$term} (and \code{object\$by}). The \code{by} variable 
is the last element.
\item[\code{knots}] a list containing any knots supplied for basis setup --- in same order and with same names as \code{data}. 
Can be \code{NULL}. See details for further information.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Tensor product smooths are smooths of several variables which allow the degree of smoothing to be different with respect
to different variables. They are useful as smooth interaction terms, as they are invariant to linear rescaling of the covariates,
which means, for example, that they are insensitive to the measurement units of the different covariates. They are also useful 
whenever isotropic smoothing is inappropriate. See \code{\LinkA{te}{te}}, \code{\LinkA{smooth.construct}{smooth.construct}} and 
\code{\LinkA{smooth.terms}{smooth.terms}}.
\end{Details}
\begin{Value}
An object of class \code{"tensor.smooth"}. See \code{\LinkA{smooth.construct}{smooth.construct}}, 
for the elements that this object will contain.
\end{Value}
\begin{Author}\relax
Simon N. Wood \email{simon.wood@r-project.org}
\end{Author}
\begin{References}\relax
Wood, S.N. (2006) Low rank scale invariant tensor product smooths for
generalized additive mixed models. Biometrics 62(4):1025-1036
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{cSplineDes}{cSplineDes}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## see ?gam

\end{ExampleCode}
\end{Examples}

