Skip to Content
Home » Language reference » glsControl {nlme}

glsControl {nlme}

Control Values for gls Fit
Package: 
nlme
Version: 
3.1-109

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 to the gls function.

Usage

glsControl(maxIter, msMaxIter, tolerance, msTol, msScale, msVerbose,
           singular.ok, qrTol, returnObject, apVar, .relStep,
           nlmStepMax, opt=c("nlminb", "optim"), optimMethod, 
           minAbsParApVar, natural)

Arguments

maxIter
maximum number of iterations for the gls optimization algorithm. Default is 50.
msMaxIter
maximum number of iterations for the optimization step inside the gls optimization. Default is 50.
tolerance
tolerance for the convergence criterion in the gls algorithm. Default is 1e-6.
msTol
tolerance for the convergence criterion in ms, passed as the rel.tolerance argument to the function (see documentation on ms). Default is 1e-7.
msScale
scale function passed as the scale argument to the ms function (see documentation on that function). Default is lmeScale.
msVerbose
a logical value passed as the trace argument to ms (see documentation on that function). Default is FALSE.
singular.ok
a logical value indicating whether non-estimable coefficients (resulting from linear dependencies among the columns of the regression matrix) should be allowed. Default is FALSE.
qrTol
a tolerance for detecting linear dependencies among the columns of the regression matrix in its QR decomposition. Default is .Machine$single.eps.
returnObject
a logical value indicating whether the fitted object should be returned when the maximum number of iterations is reached without convergence of the algorithm. Default is FALSE.
apVar
a logical value indicating whether the approximate covariance matrix of the variance-covariance parameters should be calculated. Default is TRUE.
.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
opt
the optimizer to be used, either nlminb (the default since (R 2.2.0) or optim (the previous default).
optimMethod
character - the optimization method to be used with the optim optimizer. The default is "BFGS". An alternative is "L-BFGS-B".
minAbsParApVar
numeric value - minimum absolute parameter value in the approximate variance calculation. The default is 0.05.
natural
logical. Should the natural parameterization be used for the approximate variance calculations? Default is TRUE.

Values

a list with components for each of the possible arguments.

See Also

gls, lmeScale

Examples

# decrease the maximum number iterations in the optimization call and
# request that information on the evolution of the ms iterations be printed
glsControl(msMaxIter = 20, msVerbose = TRUE)

Author(s)

Jos Pinheiro and Douglas Bates bates@stat.wisc.edu

Documentation reproduced from package nlme, version 3.1-109. License: GPL (>= 2)