

   LLiisstt ooff nnllss OObbjjeeccttss wwiitthh aa CCoommmmoonn MMooddeell

        nlsList(model, data, start, control, level, na.action, pool)

   AArrgguummeennttss::

      model: either a nonlinear model formula, with the
             response on the left of a `~' operator and an
             expression involving parameters, covariates, and a
             grouping factor separated by the `|' operator on
             the right, or a `selfStart' function.  The method
             function `nlsList.selfStart' is documented sepa-
             rately.

       data: a data frame in which to interpret the variables
             named in `model'.

      start: an optional named list with initial values for the
             parameters to be estimated in `model'. It is
             passed as the `start' argument to each `nls' call
             and is required when the nonlinear function in
             `model' does not inherit from class `selfStart'.

    control: a list of control values passed as the `control'
             argument to `nls'. Defaults to an empty list.

      level: an optional integer specifying the level of group-
             ing to be used when multiple nested levels of
             grouping are present.

   na.action: a function that indicates what should happen when
             the data contain `NA's.  The default action
             (`na.fail') causes `nlsList' to print an error
             message and terminate if there are any incomplete
             observations.

       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 sum-
             maries.

   DDeessccrriippttiioonn::

        `Data' is partitioned according to the levels of the
        grouping factor defined in `model' and individual `nls'
        fits are obtained for each `data' partition, using the
        model defined in `model'.

   VVaalluuee::

        a list of `nls' 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 `nlsList' object.

   SSeeee AAllssoo::

        `nls', `nlme.nlsList'.

   EExxaammpplleess::

        library(lme)
        data(Soybean)

        ## Will fail in 0.64.1 but should run in 0.65.0
        fm1 <- nlsList(weight ~ SSlogis(Time, Asym, xmid, scal) | Plot, Soybean)

