\HeaderA{lm.influence}{Regression Diagnostics}{lm.influence}
\aliasA{influence}{lm.influence}{influence}
\methaliasA{influence.glm}{lm.influence}{influence.glm}
\methaliasA{influence.lm}{lm.influence}{influence.lm}
\keyword{regression}{lm.influence}
\begin{Description}\relax
This function provides the basic quantities which are
used in forming a wide variety of diagnostics for
checking the quality of regression fits.
\end{Description}
\begin{Usage}
\begin{verbatim}
influence(model, ...)
## S3 method for class 'lm':
influence(model, do.coef = TRUE, ...)
## S3 method for class 'glm':
influence(model, do.coef = TRUE, ...)

lm.influence(model, do.coef = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{model}] an object as returned by \code{\LinkA{lm}{lm}} or \code{\LinkA{glm}{glm}}.
\item[\code{do.coef}] logical indicating if the changed \code{coefficients}
(see below) are desired.  These need \eqn{O(n^2 p)}{} computing time.
\item[\code{...}] further arguments passed to or from other methods.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The \code{\LinkA{influence.measures}{influence.measures}()} and other functions listed in
\bold{See Also} provide a more user oriented way of computing a
variety of regression diagnostics.  These all build on
\code{lm.influence}.  Note that for GLMs (other than the Gaussian
family with identity link) these are based on one-step approximations
which may be inadequate if a case has high influence.

An attempt is made to ensure that computed hat values that are
probably one are treated as one, and the corresponding rows in
\code{sigma} and \code{coefficients} are \code{NaN}.  (Dropping such a
case would normally result in a variable being dropped, so it is not
possible to give simple drop-one diagnostics.)

\code{\LinkA{naresid}{naresid}} is applied to the results and so will fill in
with \code{NA}s it the fit had \code{na.action = na.exclude}.
\end{Details}
\begin{Value}
A list containing the following components of the same length or
number of rows \eqn{n}{}, which is the number of non-zero weights.
Cases omitted in the fit are omitted unless a \code{\LinkA{na.action}{na.action}}
method was used (such as \code{\LinkA{na.exclude}{na.exclude}}) which restores them.

\begin{ldescription}
\item[\code{hat}] a vector containing the diagonal of the \sQuote{hat} matrix.
\item[\code{coefficients}] (unless \code{do.coef} is false) a matrix whose
i-th row contains the change in the estimated coefficients which
results when the i-th case is dropped from the regression.  Note
that aliased coefficients are not included in the matrix.
\item[\code{sigma}] a vector whose i-th element contains the estimate
of the residual standard deviation obtained when the i-th
case is dropped from the regression.  (The approximations needed for
GLMs can result in this being \code{NaN}.)
\item[\code{wt.res}] a vector of \emph{weighted} (or for class \code{glm}
rather \emph{deviance}) residuals.
\end{ldescription}
\end{Value}
\begin{Note}\relax
The \code{coefficients} returned by the \R{} version
of \code{lm.influence} differ from those computed by S.
Rather than returning the coefficients which result
from dropping each case, we return the changes in the coefficients.
This is more directly useful in many diagnostic measures.\\
Since these need \eqn{O(n^2 p)}{} computing time, they can be omitted by
\code{do.coef = FALSE}.

Note that cases with \code{weights == 0} are \emph{dropped} (contrary
to the situation in S).

If a model has been fitted with \code{na.action=na.exclude} (see
\code{\LinkA{na.exclude}{na.exclude}}), cases excluded in the fit \emph{are}
considered here.
\end{Note}
\begin{References}\relax
See the list in the documentation for \code{\LinkA{influence.measures}{influence.measures}}.

Chambers, J. M. (1992)
\emph{Linear models.}
Chapter 4 of \emph{Statistical Models in S}
eds J. M. Chambers and T. J. Hastie, Wadsworth \& Brooks/Cole.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{summary.lm}{summary.lm}} for \code{\LinkA{summary}{summary}} and related methods;\\
\code{\LinkA{influence.measures}{influence.measures}},\\
\code{\LinkA{hat}{hat}} for the hat matrix diagonals,\\
\code{\LinkA{dfbetas}{dfbetas}},
\code{\LinkA{dffits}{dffits}},
\code{\LinkA{covratio}{covratio}},
\code{\LinkA{cooks.distance}{cooks.distance}},
\code{\LinkA{lm}{lm}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
## Analysis of the life-cycle savings data
## given in Belsley, Kuh and Welsch.
summary(lm.SR <- lm(sr ~ pop15 + pop75 + dpi + ddpi,
                    data = LifeCycleSavings),
        corr = TRUE)
utils::str(lmI <- lm.influence(lm.SR))

## For more "user level" examples, use example(influence.measures)
\end{ExampleCode}
\end{Examples}

