\Header{logLik.reStruct}{Calculate reStruct Log-Likelihood}
\keyword{models}{logLik.reStruct}
\begin{Description}\relax
Calculates the log-likelihood, or restricted log-likelihood, of the
Gaussian linear mixed-effects model represented by \code{object} and
\code{conLin} (assuming spherical within-group covariance structure),
evaluated at \code{coef(object)}. The \code{settings} attribute of
\code{object} determines whether the log-likelihood, or the restricted
log-likelihood, is to be calculated. The computational methods are 
described in Bates and Pinheiro (1998).
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'reStruct':
logLik(object, conLin, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] an object inheriting from class \code{reStruct},
representing a random effects structure and consisting of a list of
\code{pdMat} objects.
\item[\code{conLin}] a condensed linear model object, consisting of a list
with components \code{"Xy"}, corresponding to a regression matrix
(\code{X}) combined with a response vector (\code{y}), and
\code{"logLik"}, corresponding to the log-likelihood of the
underlying model.
\item[\code{...}] some methods for this generic require additional
arguments.  None are used in this method.
\end{ldescription}
\end{Arguments}
\begin{Value}
the log-likelihood, or restricted log-likelihood, of linear
mixed-effects model represented by \code{object} and \code{conLin},
evaluated at \code{coef\{object\}}.
\end{Value}
\begin{Author}\relax
Jose Pinheiro \email{Jose.Pinheiro@pharma.novartis.com} and Douglas Bates \email{bates@stat.wisc.edu}
\end{Author}
\begin{References}\relax
Bates, D.M. and Pinheiro, J.C. (1998) "Computational methods for
multilevel models" available in PostScript or PDF formats at
http://franz.stat.wisc.edu/pub/NLME/
\end{References}
\begin{SeeAlso}\relax
\code{\Link{reStruct}}, \code{\Link{pdMat}}
\end{SeeAlso}

