influence.mixpoissonreg {mixpoissonreg} | R Documentation |
Global Influence Diagnostics for Mixed Poisson Regression Models
Description
These functions provides global influence diagnostic quantities such as Cook's distance, hat values, generalized Cook's distance (through argument
on cooks.distance.mixpoissonreg
function), likelihood displacement (through argument
on cooks.distance.mixpoissonreg
function) and Q-displacement (through argument
on cooks.distance.mixpoissonreg
function).
Usage
## S3 method for class 'mixpoissonreg'
hatvalues(model, parameters = c("mean", "precision"), ...)
## S3 method for class 'mixpoissonreg'
cooks.distance(
model,
type = c("CD", "GCD", "GCDmean", "GCDprecision", "LD", "QD"),
hat = c("mean", "precision"),
...
)
## S3 method for class 'mixpoissonreg'
influence(model, do.coef = TRUE, ...)
Arguments
model |
a |
parameters |
the parameter to which the hat values will be computed. The options are 'mean' and 'precision'. The default is 'mean'. For hatvalues with respect to the mean the model must be fitted with 'x' set to TRUE, and for hatvalues with respect to the precision the model must be fitted with 'w' set to TRUE. |
... |
Currently not used. |
type |
the type of Cook's distance to be used. The options are 'CD', the standard Cook's distance; 'GCD', the generalized Cook's distance with respect to all parameters, Zhu et al. (2001); 'GCDmean', the generalized Cook's distance with respect to the mean parameters; 'GCDprecision', the generalized Cook's distance with respect to the precision parameters; 'LD', the likelihood displacement (also known as likelihood distance), see Cook and Weisberg (1982); 'QD', the Q-displacement, see Zhu et al. (2001). See 'details' for more informations. For 'GCD', 'GCDmean', 'LD' and 'QD', the model must be fitted with 'x' set to TRUE, and for 'GCD', 'GCDprecision', 'LD' and 'QD', the model must be fitted with 'w' set to TRUE. For 'CD', if 'hat' is set to 'mean', the model must be fitted with 'x' set to TRUE, whereas if 'hat' is set to 'precision', the model must be fitted with 'w' set to TRUE. |
hat |
hat values |
do.coef |
logical indicating if the the approximation to the change of coefficients values after case removal are desired. The model must be fitted with x = TRUE. See details for further explanations. |
Details
For hat values of mixed Poisson regression models, we follow Zhu et al. (2001) to consider the negative of the hessian of the Q-function as weight matrix, and follow Pregibon (1981) to define the 'hat' matrix with respect to this weight matrix. We can consider the hessian of the Q-function with respect to mean-related parameters, which is the default. We can also consider the hessian of the Q-function with respect to the precision-related parameters to give rise to hat values related to the precision parameters.
The Generalized Cook's distance and Q-displacement for EM-based models were defined in Zhu et al. (2001) and computed for mixed Poisson regression models in Barreto-Souza and Simas (2016). We implemented first-order approximation to these quantities to make it computationally feasible. These first-order approximations are available in Barreto-Souza and Simas (2016). We also provide versions of generalized Cook's distance for mean-related or precision-related parameters, whose details can be found in Barreto-Souza and Simas (2016).
In the influence method we provide a 'do.coef' argument that computes first-order approximations to the impact of removal of each case to each parameter, in the same spirit as the 'do.coeff' argument in 'influence.lm'.
Value
The method influence.mixpoissonreg
returns a list containing
hat.mean, a vector containing the hat values with respect to the mean, hat.precision,
a vector containing the hat values with respect to the precision, coefficients.mean (if do.coef=TRUE
), a matrix
containing the first
order approximations for the mean-related coefficients after the removal
of each observation, coefficients.precision (if do.coef=TRUE
), a matrix containing the first
order approximations for the precision-related coefficients after the removal
of each observation, pear.res, a vector containing the Pearson residuals,
score.res, a vector containing the score residuals.
The cooks.distance.mixpoissonreg returns a vector containing the Cook's distances.
The hatvalues.mixpoissonreg returns a vector containing the hat values.
References
DOI:10.1007/s11222-015-9601-6 doi: 10.1007/s11222-015-9601-6(Barreto-Souza and Simas, 2016)
Cook, D.R. and Weisberg, S. (1982) Residuals and Influence in Regression. (New York: Chapman and Hall, 1982)
Pregibon, D. (1981) Logistic Regression Diagnostics. Ann. Stat. 9, 705-724.
Zhu, H.T., Lee, S.Y., Wei, B.C., Zhu, J. (2001) Case-deletion measures formodels with incomplete data. Biometrika, 88, 727–737.