| 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: data(Orthodont) 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)