addrm.terms.asrtests {asreml3Plus} | R Documentation |
The specified terms are simply added or removed from either the
fixed or random model. No hypothesis testing is performed and no check
is made for boundary or singular terms. A row is added to the
test.summary
data.frame
stating whether fixed or random terms
have been added or removed. Convergence in fitting the model is checked
and a note included in the action if there was not. All components of the
asrtests
object are updated, although wald.tab
is only updated
if it is present in the supplied asrtests
object.
addrm.terms.asrtests(terms = NULL, asrtests.obj, add = FALSE, random = FALSE, label = NULL, allow.unconverged = TRUE, denDF = "default", trace = FALSE, update = TRUE, set.terms = NULL, ignore.suffices = TRUE, constraints = "P", initial.values = NA, ...)
terms |
A single character string in the form of a formula which, after expansion, specifies the sum of a set of terms to be added or dropped. |
asrtests.obj |
An |
add |
Whether to add or remove terms from the model. |
random |
Whether terms are to added or removed from the fixed or random model. |
label |
A character string to use as the label in |
allow.unconverged |
A |
denDF |
Specifies the enthod to use in computing approximate denominator
degrees of freedom when |
trace |
If TRUE then partial iteration details are displayed when ASReml-R functions are invoked; if FALSE then no output is displayed. |
update |
If |
set.terms |
A character vector specifying the terms that are to have constraints and/or initial values set prior to fitting. |
ignore.suffices |
A logical vector specifying whether the suffices of the
|
constraints |
A character vector specifying the constraints to be applied
to the terms specified in |
initial.values |
A character vector specifying the initial values for
the terms specified in |
... |
Further arguments passed to |
An asrtests
object, which is a list containing:
asreml.obj
: an asreml
object containing the fit
of the model after all boundary and singular terms have been removed;
wald.tab
: a 4-column data.frame
containing a
pseudo-anova table for the fixed terms produced by wald.asreml
;
test.summary
: a data.frame
with columns term
,
DF
, denDF
, p
and action
. A row is added to
it for each term
that is dropped, added or tested or a note that several terms have been
added or removed. A row contains the name of the term, the
DF, the p-value and the action taken. Possible codes are:
Dropped
, Retained
, Swapped
, Unswapped
,
Significant
, Nonsignificant
, Absent
, Added
,
Removed
and Boundary
. If the changed model did not
converge, Unconverged
will be added to the code.
Note that the logical asreml.obj$converge
also
reflects whether there is convergence.
asrtests
, rmboundary.asrtests
,
testranfix.asrtests
, testrcov.asrtests
,
newfit.asreml
, sig.devn.reparam.asrtests
,
choose.model.asrtests
## Not run: terms <- "(Date/(Sources * (Type + Species)))" current.asrt <- addrm.terms.asrtests(terms, current.asrt, add = TRUE) current.asrt <- addrm.terms.asrtests("A + B", current.asrt, denDF = "algebraic") ## End(Not run)