update.asreml {asreml}R Documentation

Update an asreml model.

Description

Extract and evaluate the call from the fitted object, replacing any arguments with changed values. In particular, G.param and R.param are automatically updated with those stored in the object.

Usage

## S3 method for class 'asreml'
update(object, fixed., random., sparse., residual.,
  keep.order = TRUE, evaluate = TRUE, ...)

Arguments

object

A valid asreml object with a call component, the expression used to create itself.

fixed.

Changes to the fixed formula. This is a two sided formula where "." is substituted for existing components in the fixed component of object$call.

random.

Changes to the random formula. This is a one sided formula where "." is substituted for existing components in the right hand side of the random component of object$call.

sparse.

Changes to the sparse formula. This is a one sided formula where "." is substituted for existing components in the right hand side of the sparse component of object$call.

residual.

Changes to the residual formula. This is a one sided formula where "." is substituted for existing components in the right hand side of the residual component of object$call.

keep.order

If TRUE (the default) the ordering of terms is retained in the updated formulae.

evaluate

If TRUE (the default) the new call is evaluated; otherwise the call is returned as an unevaluated expression.

...

Additional arguments to the call, or arguments with changed values.

Details

In addition to any other changes, update.asreml replaces the arguments R.param and G.param with object\$R.param and object\$G.param, respectively, creating a new fitted object when run using the parameter values from a previous model as initial values.

Value

Either a new updated asreml object, else an unevaluated expression for creating such an object.

Examples


## Not run: 
data(oats, package="asreml")
oats.asr <- asreml(yield ~ Variety+Nitrogen,
                  random = ~ Blocks/Wplots, data=oats)
oats2.asr <- update(oats.asr, fixed = . ~ . + Variety:Nitrogen)

## End(Not run)


[Package asreml version 4.1.0.106 Index]