Documented here are the "cplm" class and its derived classes "cpglm", "cpglmm", and "bcplm". Several primitive methods and statistical methods are created to facilitate the extraction of specific slots and further statistical analysis. "gini" is a class that stores the Gini indices and associated standard errors that could be used to perform model comparison involving the compound Poisson distribution. "NullNum", "NullList", "NullFunc" and "ListFrame" are virtual classes for c("NULL", "numeric"), c("NULL","list"), c("NULL","function") and c("list","data.frame"), respectively.
"cplm"Objects can be created by calls of the form new("cplm", ...).
"cpglm"Objects can be created by calls from new("cpglm", ...) or cpglm.
"cpglmm"Objects can be created by calls of the form new("cpglmm", ...), or a call to cpglmm.
"summary.cpglmm"Objects can be created by calls of the form new("summary.cpglmm", ...), or a call to summary on a cpglmm object.
"bcplm"Objects can be created by calls from new("bcplm", ...) or bcplm.
"gini"Objects can be created by calls from new("gini", ...) or gini.
"NullNum", "NullList", "NullFunc"These are virtual classes and no objects may be created from them.
The "cplm" class defines the slots common in all the model classes in the cplm package, and thus the utility methods defined on the "cplm" class such as [, names and so on are applicable to all of the derived classes.
call:the matched call.
formula:the formula supplied, class "formula"
contrasts:the contrasts used, class "NullList"
link.power:index of power link function, class "numeric". See tweedie.
model.frame:the data frame used. class "ListFrame".
inits:initial values used, class "NullList".
The "cpglm" class extends "cplm" directly. Most of the slots have the same definition as those in glm. The following slots are in addition to those in "cplm":
coefficients:estimated mean parameters, class "numeric".
residuals:the working residuals, that is the residuals in the final iteration of the IWLS fit, class "numeric"
fitted.values:the fitted mean values, obtained by transforming the linear predictors by the inverse of the link function, class "numeric"
linear.predictors:the fitted linear predictors, class "numeric"
weights:working weights from the last iteration of the iterative least square, class "numeric"
df.residual:residual degrees of freedom, class "integer"
deviance:up to a constant, minus twice the maximized log-likelihood. Where sensible, the constant is chosen so that a saturated model has deviance zero. This is computed using tweedie.dev.
aic:a version of Akaike's Information Criterion, minus twice the maximized log-likelihood plus twice the number of mean parameters. This is computed using the tweedie density approximation as in dtweedie.
offset:the offset vector used, class "NullNum",
prior.weights:the weights initially supplied, a vector of 1s if none were, class "NullNum"
y:the response vector used.
control:the value of the control argument used, class "list"
p:the maximum likelihood estimate of the index parameter.
phi:the maximum likelihood estimate of the dispersion parameter.
vcov:estimated variance-covariance matrix, class "matrix"
iter:the number of Fisher's scoring iterations in the final GLM.
converged:indicating whether the algorithm has converged, class "logical".
na.action:method of handling NA's, class "NullFunc".
The "cpglmm" class extends "cplm" and the old version of "mer" class from lme4 directly, and has the following additional slots:
p:estimated value of the index parameter, class "numeric"
phi:estimated value of the dispersion parameter, class "numeric"
bound.p:the specified bounds of the index parameter, class "numeric"
vcov:estimated variance-covariance matrix, class "matrix"
smooths:a list of smooth terms
The slots it used from the old "mer" class has the following slots (copied from lme4_0.999999-2):
env:An environment (class "environment")
created for the evaluation of the nonlinear model function.
nlmodel:The nonlinear model function as an object of
class "call".
frame:The model frame (class "data.frame").
call:The matched call to the function that
created the object. (class "call").
flist:The list of grouping factors for the random effects.
X:Model matrix for the fixed effects.
Zt:The transpose of model matrix for the random
effects, stored as a compressed column-oriented sparse matrix (class
"dgCMatrix").
pWt:Numeric prior weights vector. This may be of length zero (0), indicating unit prior weights.
offset:Numeric offset vector. This may be of length zero (0), indicating no offset.
y:The response vector (class "numeric").
Gp:Integer vector of group pointers within the random
effects vector. The elements of Gp are 0-based indices of
the first element from each random-effects term. Thus the first
element is always 0. The last element is the total length of the
random effects vector.
dims:A named integer vector of dimensions. Some of the dimensions are \(n\), the number of observations, \(p\), the number of fixed effects, \(q\), the total number of random effects, \(s\), the number of parameters in the nonlinear model function and \(nt\), the number of random-effects terms in the model.
ST:A list of S and T factors in the TSST' Cholesky factorization of the relative variance matrices of the random effects associated with each random-effects term. The unit lower triangular matrix, \(T\), and the diagonal matrix, \(S\), for each term are stored as a single matrix with diagonal elements from \(S\) and off-diagonal elements from \(T\).
V:Numeric gradient matrix (class "matrix") of
the nonlinear model function.
A:Scaled sparse model matrix (class
"dgCMatrix") for
the the unit, orthogonal random effects, \(U\).
Cm:Reduced, weighted sparse model matrix (class
"dgCMatrix") for the
unit, orthogonal random effects, U. .
Cx:The "x" slot in the weighted sparse model
matrix (class "dgCMatrix")
for the unit, orthogonal random effects, \(U\), in generalized
linear mixed models. For these models the matrices \(A\) and
\(C\) have the same sparsity pattern and only the "x"
slot of \(C\) needs to be stored.
L:The sparse lower Cholesky factor of \(P(AA'+I)P'\)
(class "dCHMfactor") where \(P\)
is the fill-reducing permutation calculated from the pattern of
nonzeros in \(A\).
deviance:Named numeric vector containing the deviance
corresponding to the maximum likelihood (the "ML" element)
and "REML" criteria and various components. The
"ldL2" element is twice the logarithm of the determinant of
the Cholesky factor in the L slot. The "usqr"
component is the value of the random-effects quadratic form.
fixef:Numeric vector of fixed effects.
ranef:Numeric vector of random effects on the original scale.
u:Numeric vector of orthogonal, constant variance, random effects.
eta:The linear predictor at the current values of the parameters and the random effects.
mu:The means of the responses at the current parameter values.
muEta:The diagonal of the Jacobian of \(\mu\) by \(\eta\). Has length zero (0) except for generalized mixed models.
var:The diagonal of the conditional variance of
\(Y\) given the random effects, up to prior weights. In
generalized mixed models this is the value of the variance
function for the glm family.
resid:The residuals, \(y - \mu\), weighted by
the sqrtrWt slot (when its length is \(>0\)).
sqrtXWt:The square root of the weights applied to the model matrices \(X\) and \(Z\). This may be of length zero (0), indicating unit weights.
sqrtrWt:The square root of the weights applied to the residuals to obtain the weighted residual sum of squares. This may be of length zero (0), indicating unit weights.
RZX:The dense solution (class "matrix") to
\(L RZX = ST'Z'X = AX\).
RX:The upper Cholesky factor (class "matrix")
of the downdated \(X'X\).
The "summary.cpglmm" class contains the "cpglmm"
class and has the following additional slots:
methTitle:character string specifying a method title
logLik:the same as logLik(object).
ngrps:the number of levels per grouping factor in the
flist slot.
sigma:the scale factor for the variance-covariance estimates
coefs:the matrix of estimates, standard errors, etc. for the fixed-effects coefficients
REmat:the formatted Random-Effects matrix
AICtab:a named vector of values of AIC, BIC, log-likelihood and deviance
The "bcplm" class extends "cplm" directly, and has the following additional slots:
dims:a named integer vector of dimensions.
sims.list:an object of class "mcmc.list". It is a list of n.chains mcmc objects, each mcmc object storing the simulation result from a Markov chain. See mcmc and mcmc.convert. Since this is an "mcmc.list" object, most methods defined in the coda package can be directly applied to it.
Zt:the transpose of model matrix for the random effects, stored as a compressed column-oriented sparse matrix (class "dgCMatrix").
flist:the list of grouping factors for the random effects.
prop.var:a named list of proposal variance-covariance matrix used in the Metropolis-Hasting update.
The "gini" class has the following slots:
call:the matched call.
gini:a matrix of the Gini indices. The row names are corresponding to the base while the column names are corresponding to the scores.
sd:a matrix of standard errors for each computed Gini index.
lorenz:a list of matrices that determine the graph of the ordered Lorenz curve associated with each base and score combination. For each base, there is an associated matrix.
Class "cpglm" extends class "cplm", directly.
Class "cpglmm" extends class "cplm", directly;
Class "summary.cpglmm" extends class "cpglmm", directly;
class "cplm", by class "cpglmm", distance 2.
Class "bcplm" extends class "cplm", directly.
The following methods are defined for the class "cplm", which are also applicable to all of the derived classes:
signature(x = "cplm"): extract a slot of x with a specified slot name, just as in list.
signature(x = "cplm", i = "numeric", j = "missing"): extract the i-th slot of a "cpglm" object, just as in list.
signature(x = "cplm", i = "character", j = "missing"): extract the slots of a "cpglm" object with names in i, just as in list.
signature(x = "cplm", i = "numeric", j = "missing", drop="missing"): extract the i-th slot of a "cpglm" object, just as in list. i could be a vector.
signature(x = "cplm", i = "character", j = "missing", drop="missing"): extract the slots of a "cpglm" object with names in i, just as in list. i could be a vector.
signature(x = "cplm"): return the slot names.
signature(x = "cplm"): extract the terms object from the model frame. See terms.
signature(x = "cplm"): extract the formula slot. See formula.
signature(object = "cplm"): extract the design matrix.
signature(object = "cplm"): method for show.
signature(object = "cplm"): extract the variance-covariance matrix of a "cplm" object.
The following methods are defined for the "cpglm" class:
signature(object = "cpglm"): extract the estimated coefficients.
signature(object = "cpglm"): return the fitted values.
signature(object = "cpglm"): extract residuals from a cpglm object. You can also specify a type argument to indicate the type of residuals to be computed. See glm.summaries.
signature(object = "cpglm"): same as residuals.
signature(object = "cpglm",k="missing"): extract the AIC information from the "cpglm" object. See AIC.
signature(object = "cpglm"): extract the deviance from the "cpglm" object. See deviance.
signature(object = "cpglm"): the same as glm.summaries except that both the dispersion and the index parameter are estimated using maximum likelihood estimation.
signature(object = "cpglm"): generate predictions for new data sets
The following are written for "cpglmm":
signature(x = "cpglmm"): print the object
signature(object = "cpglmm"): summary results
signature(object = "cpglmm"): generate predictions for new data sets
signature(x = "cpglmm"): estimation for the variance components
signature(object = "cpglmm"): variance-covariance matrix for fixed effects
The following methods are available for the class "bcplm":
signature(x = "bcplm", y = "missing"): summarize the "bcplm" object with a trace of the sampled output and a density estimate for each variable in the chain. See plot.mcmc.
signature(object = "bcplm"): produce two sets of summary statistics. See summary.mcmc.
signature(x = "bcplm"): estimation for the variance components if the random effects are present
signature(object = "bcplm"): extract fixed effects. Additional arguments include: sd = FALSE: extract standard errors; quantiles = NULL: compute empirical quantiles. These additional statistics are stored as attributes in the returned results.
The following methods are defined for the "gini" class:
signature(x = "gini", y = "missing"): plot the ordered Lorenz curve from each model comparison. If overlay = TRUE (the default), different curves are plotted on the same graph for each base.
signature(object = "gini"): print the computed Gini indices and standard errors.
Wayne Zhang actuary_zhang@hotmail.com
See also cpglm, cpglmm, bcplm, glm.