.\" -*- nroff -*- generated from .Rd format
.BG
.FN lmList
.TL
List of lm Objects with a Common Model
.DN
`Data' is partitioned according to the levels of the grouping
factor `g' and individual `lm' fits are obtained for each
`data' partition, using the model defined in `object'.
.CS
lmList(object, data, level, na.action, pool)
.RA
.AG object
either a linear formula object of the form `y ~ x1+...+xn | g'
or a `groupedData' object. In the formula object, `y'
represents the response, `x1,...,xn' the covariates, and
`g' the grouping factor specifying the partitioning of the data
according to which different `lm' fits should be performed. The
grouping factor `g' may be omitted from the formula, in which
case the grouping structure will be obtained from `data', which
must inherit from class `groupedData'. The method function 
`lmList.groupedData' is documented separately.
.AG data
an data frame in which to interpret the variables named in
`object'. 
.OA
.AG level
an optional integer specifying the level of grouping to be used when 
multiple nested levels of grouping are present.
.AG na.action
a function that indicates what should happen when the
data contain `NA's.  The default action (`na.fail') causes
`lmList' to print an error message and terminate if there are any
incomplete observations.
.AG pool
an optional logical value that is preserved as an attribute of the
returned value.  This will be used as the default for `pool' in
calculations of standard deviations or standard errors for summaries.

.RT
a list of `lm' objects with as many components as the number of
groups defined by the grouping factor. Generic functions such as
`coef', `fixed.effects', `lme', `pairs',
`plot', `predict', `random.effects', `summary',
and `update' have methods that can be applied to an `lmList'
object.

.SA
`lm', `lme.lmList'.
.EX
fm1 <- lmList(distance ~ age | Subject, Orthodont)
.KW models
.WR
