\HeaderA{gamma.shape}{Estimate the Shape Parameter of the Gamma Distribution in a GLM Fit}{gamma.shape}
\methaliasA{gamma.shape.glm}{gamma.shape}{gamma.shape.glm}
\aliasA{print.gamma.shape}{gamma.shape}{print.gamma.shape}
\keyword{models}{gamma.shape}
\begin{Description}\relax
Find the maximum likelihood estimate of the shape parameter of
the gamma distribution after fitting a \code{Gamma} generalized
linear model.
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'glm':
gamma.shape(object, it.lim = 10,
            eps.max = .Machine$double.eps^0.25, verbose = FALSE, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] Fitted model object from a \code{Gamma} family or \code{quasi} family with
\code{variance = mu\textasciicircum{}2}.

\item[\code{it.lim}] Upper limit on the number of iterations.

\item[\code{eps.max}] Maximum discrepancy between approximations for the iteration
process to continue.

\item[\code{verbose}] If \code{TRUE}, causes successive iterations to be printed out.  The
initial estimate is taken from the deviance.

\item[\code{...}] further arguments passed to or from other methods.

\end{ldescription}
\end{Arguments}
\begin{Details}\relax
A glm fit for a Gamma family correctly calculates the maximum
likelihood estimate of the mean parameters but provides only a
crude estimate of the dispersion parameter.  This function takes
the results of the glm fit and solves the maximum likelihood
equation for the reciprocal of the dispersion parameter, which is
usually called the shape (or exponent) parameter.
\end{Details}
\begin{Value}
List of two components

\begin{ldescription}
\item[\code{alpha}] the maximum likelihood estimate

\item[\code{SE}] the approximate standard error, the square-root of the reciprocal of
the observed information.

\end{ldescription}
\end{Value}
\begin{References}\relax
Venables, W. N. and Ripley, B. D. (2002)
\emph{Modern Applied Statistics with S.} Fourth edition.  Springer.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{gamma.dispersion}{gamma.dispersion}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
clotting <- data.frame(
    u = c(5,10,15,20,30,40,60,80,100),
    lot1 = c(118,58,42,35,27,25,21,19,18),
    lot2 = c(69,35,26,21,18,16,13,12,12))
clot1 <- glm(lot1 ~ log(u), data = clotting, family = Gamma)
gamma.shape(clot1)
## Not run: 
Alpha: 538.13
   SE: 253.60
## End(Not run)
gm <- glm(Days + 0.1 ~ Age*Eth*Sex*Lrn,
                quasi(link=log, variance=mu^2), quine, start = rep(0,32))
gamma.shape(gm, verbose = TRUE)
## Not run: 
Initial estimate: 1.0603
Iter.  1  Alpha: 1.23840774338543
Iter.  2  Alpha: 1.27699745778205
Iter.  3  Alpha: 1.27834332265501
Iter.  4  Alpha: 1.27834485787226

Alpha: 1.27834
   SE: 0.13452
## End(Not run)
summary(gm, dispersion = gamma.dispersion(gm))  # better summary
\end{ExampleCode}
\end{Examples}

