\Header{full.score}{GCV/UBRE score for use within nlm}
\keyword{models}{full.score}
\keyword{smooth}{full.score}
\keyword{regression}{full.score}
\begin{Description}\relax
\code{gam} allows the option to `polish' smoothing parameter 
estimates by minimising the GCV/UBRE score calculated at convergence of the IRLS 
algorithm, given a set of smoothing parameters, rather than using the `performance 
iteration' method which estimates smoothing parameters within the IRLS loop. The 
estimates are often slightly different, since the performance iteration effectively 
neglects the dependence of the iterative weights on the smoothing parameters.

The `polishing' optimisation is fairly crude and numerically costly. 
\code{\Link{nlm}} is used to minimise the scores with respect to the smoothing 
parameters, and this routine is designed to be supplied to it as an argument. 

This is basically a service routine for \code{\Link{gam}}, and is not usually 
called directly by users.
\end{Description}
\begin{Usage}
\begin{verbatim}
full.score(sp,G,family,control,gamma)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{sp}] The logs of the smoothing parameters
\item[\code{G}] a list returned by \code{\Link{gam.setup}}
\item[\code{family}] The family object for the GAM.
\item[\code{control}] a list returned be \code{\Link{gam.control}}
\item[\code{gamma}] the degrees of freedom inflation factor (usually 1).
\end{ldescription}
\end{Arguments}
\begin{Value}
The value of the GCV/UBRE score, with attribute \code{"full.gam.object"}
which is the full object returned by \code{\Link{gam.fit}}.
\end{Value}
\begin{Author}\relax
Simon N. Wood \email{simon@stats.gla.ac.uk}
\end{Author}

