plot.ranef.lme {nlme} | R Documentation |
If form
is missing, or is given as a one-sided formula, a
Trellis dot-plot of the random effects is generated, with a different
panel for each random effect (coefficient). Rows in the dot-plot are
determined by the form
argument (if not missing) or by the row
names of the random effects (coefficients). If a single factor is
specified in form
, its levels determine the dot-plot rows
(with possibly multiple dots per row); otherwise, if form
specifies a crossing of factors, the dot-plot rows are determined by
all combinations of the levels of the individual factors in the
formula. The Trellis function dotplot
is used in this method
function.
If form
is a two-sided formula, a Trellis display is generated,
with a different panel for each variable listed in the right hand side
of form
. Scatter plots are generated for numeric variables and
boxplots are generated for categorical (factor
or
ordered
) variables.
## S3 method for class 'ranef.lme': plot(x, form, omitFixed, level, grid, control, ...)
x |
an object inheriting from class
ranef.lme , representing the estimated coefficients or
estimated random effects for the lme object from which it was
produced. |
form |
an optional formula specifying the desired type of plot. If
given as a one-sided formula, a dotplot of the estimated
random effects (coefficients) grouped according to all combinations of
the levels of the factors named in form is returned. Single
factors (~g ) or crossed factors (~g1*g2 ) are
allowed. If given as a two-sided formula, the left hand side must
be a single random effects (coefficient) and the right hand side
is formed by covariates in x separated by + . A
Trellis display of the random effect (coefficient) versus the named
covariates is returned in this case. Default is NULL , in
which case the row names of the random effects (coefficients) are
used. |
omitFixed |
an optional logical value indicating whether
columns with values that are constant across groups should be
omitted. Default is TRUE . |
level |
an optional integer value giving the level of grouping
to be used for x . Only used when x is a list
with different components for each grouping level. Defaults to the
highest or innermost level of grouping. |
grid |
an optional logical value indicating whether a grid should
be added to plot. Only applies to plots associated with two-sided
formulas in form . Default is FALSE . |
control |
an optional list with control values for the
plot, when form is given as a two-sided formula. The control
values are referenced by name in the control list and only
the ones to be modified from the default need to be
specified. Available values include: drawLine , a logical
value indicating whether a loess smoother should be added to
the scatter plots and a line connecting the medians should be added
to the boxplots (default is TRUE ); span.loess , used
as the span argument in the call to panel.loess
(default is 2/3 ); degree.loess , used as the
degree argument in the call to panel.loess (default
is 1 ); cex.axis , the character expansion factor for
the x-axis (default is 0.8 ); srt.axis , the rotation
factor for the x-axis (default is 0 ); and mgp.axis , the
margin parameters for the x-axis (default is c(2, 0.5, 0) ). |
... |
optional arguments passed to the Trellis dotplot
function. |
a Trellis plot of the estimated random-effects (coefficients) versus covariates, or groups.
Jose Pinheiro Jose.Pinheiro@pharma.novartis.com and Douglas Bates bates@stat.wisc.edu
## Not run: fm1 <- lme(distance ~ age, Orthodont, random = ~ age | Subject) plot(ranef(fm1)) fm1RE <- ranef(fm1, aug = TRUE) plot(fm1RE, form = ~ Sex) plot(fm1RE, form = age ~ Sex) ## End(Not run)