nlme (version 3.1-1)

coef.lme: Extract lme Coefficients

Description

The estimated coefficients at level $i$ are obtained by adding together the fixed effects estimates and the corresponding random effects estimates at grouping levels less or equal to $i$. The resulting estimates are returned as a data frame, with rows corresponding to groups and columns to coefficients. Optionally, the returned data frame may be augmented with covariates summarized over groups.

Usage

coef(object, augFrame, level, data, which, FUN, omitGroupingFactor)

Arguments

object

an object inheriting from class lme, representing a fitted linear mixed-effects model.

augFrame

an optional logical value. If TRUE, the returned data frame is augmented with variables defined in data; else, if FALSE, only the coefficients are returned. Defaults to FALSE.

level

an optional positive integer giving the level of grouping to be used in extracting the coefficients from an object with multiple nested grouping levels. Defaults to the highest or innermost level of grouping.

data

an optional data frame with the variables to be used for augmenting the returned data frame when augFrame = TRUE. Defaults to the data frame used to fit object.

which

an optional positive integer or character vector specifying which columns of data should be used in the augmentation of the returned data frame. Defaults to all columns in data.

FUN

an optional summary function or a list of summary functions to be applied to group-varying variables, when collapsing data by groups. Group-invariant variables are always summarized by the unique value that they assume within that g

omitGroupingFactor

an optional logical value. When TRUE the grouping factor itself will be omitted from the group-wise summary of data but the levels of the grouping factor will continue to be used as the row names for the returned data f

Value

• a data frame inheriting from class coef.lme with the estimated coefficients at level level and, optionally, other covariates summarized over groups. The returned object also inherits from classes ranef.lme and data.frame.

See Also

lme, fixef.lme, ranef.lme, plot.ranef.lme, gsummary

Examples

data(Orthodont)
fm1 <- lme(distance ~ age, Orthodont, random = ~ age | Subject)
coef(fm1)
coef(fm1, augFrame = TRUE)