lme4 (version 0.8-3)

lmeControl: Control values for lme

Description

The values supplied in the function call replace the defaults and a list with all possible arguments is returned. The returned list is used as the control argument in the lme function.

Usage

lmeControl(maxIter, msMaxIter, tolerance, niterEM, msTol,
           msVerbose, PQLmaxIt, .relStep, nlmStepMax, 
           EMverbose, analyticGradient, analyticHessian)

Arguments

maxIter
maximum number of iterations for the lme optimization algorithm. Default is 50.
msMaxIter
maximum number of iterations for the nlm optimization step inside the lme optimization. Default is 50.
tolerance
tolerance for the convergence criterion in the lme algorithm. Default is 1e-6.
niterEM
number of iterations for the EM algorithm used to refine the initial estimates of the random effects variance-covariance coefficients. Default is 25.
msTol
tolerance for the convergence criterion in nlm, passed as the rel.tolerance argument to the function (see documentation on nlm). Default is 1e-7.
msVerbose
a logical value passed as the trace argument to nlm (see documentation on that function). Default is getOption("verbose").
PQLmaxIt
maximum number of iterations for the PQL algorithm in GLMM.
.relStep
relative step for numerical derivatives calculations. Default is .Machine$double.eps^(1/3).
nlmStepMax
stepmax value to be passed to nlm. See nlm for details. Default is 100.0
EMverbose
a logical value indicating if verbose output should be produced during the EM iterations. Default is getOption("verbose".
analyticGradient
a logical value indicating if the analytic gradient of the objective should be used. This option is for testing purposes and would not normally be changed from the default. Default is TRUE.
analyticHessian
a logical value indicating if the analytic hessian of the objective should be calculated. This is an experimental feature and at present the default is FALSE. In future we may use the analytic Hessian in the optimization.

Value

  • a list with a component for each of the possible arguments.

synopsis

lmeControl(maxIter = 50, msMaxIter = 50, tolerance = sqrt((.Machine$double.eps)), niterEM = 20, msTol = sqrt(.Machine$double.eps), msVerbose = getOption("verbose"), PQLmaxIt = 20, .relStep = (.Machine$double.eps)^(1/3), nlmStepMax = NULL, EMverbose = getOption("verbose"), analyticGradient = TRUE, analyticHessian=FALSE))

See Also

lme, nlm, optim, lmeScale, GLMM

Examples

Run this code
# decrease the maximum number iterations in the ms call and
# request that information on the evolution of the ms iterations be printed
str(lmeControl(msMaxIter = 20, msVerbose = TRUE))

Run the code above in your browser using DataCamp Workspace