Extracts the REML log likelhood and the number of variance
parameters from two asreml
objects. It assumes that that the
first asreml
object corresponds to the null hypothesis and
the second asreml
object to the alternative hypothesis for the
test being conducted. That is, the second
asreml
object is the result of fitting a model that is a
reduced version of the model for the first object. In the case
where the reduced model is obtained by setting positively-constrained
variance parameters in the full model to zero, the positive.zero
argument should be set to TRUE
so that
the p-value is computed using a mixture of chi-square distributions as
described in Self and Liang (1987).
The function checks that the models do not differ in either their fixed or sparse models.
# S3 method for asreml
REMLRT(h0.asreml.obj, h1.asreml.obj,
positive.zero = FALSE, bound.test.parameters = "none",
DF = NULL, bound.exclusions = c("F","B","S","C"), ...)
asreml
object containing the fit under the model for the
null hypothesis.
asreml
object containing the fit under the model for the
alternative hypothesis.
Indicates whether the hypothesized values for the
variance components being tested are on the boundary
of the parameter space. For example, this is true
for positively-constrained variance components that,
under the reduced model, are zero. This argument does
not need to be set if bound.test.parameters
is set.
Indicates whether for the variance components
being tested, at least some of the hypothesized values
are on the boundary of the parameter space.
The possibilities are "none"
, "onlybound"
and "one-and-one"
. The default is "none"
,
although if it is set to "none"
and
positive.zero
is TRUE
then
bound.test.parameters
is taken to be "onlybound"
.
When bound.test.parameters
is set to
"one-and-one"
, it signifies that there are two
parameters being tested, one of which is bound and the
other is not. For example, the latter is true for testing
a covariance and a positively-constrained variance component
that, under the reduced model, are zero.
A numeric
giving the difference between the two models in the
number of variance parameters whose estimates are not of the type
specified in bound.exclusions
. If
NULL
then this is determined from the information in
full.asreml.obj
and reduced.asreml.obj
.
A character
specifying one or more bound (constraint) codes that
will result in a variance parameter being excluded from the count of
estimated variance parameters. If set to NULL
then none will
be excluded.
Provision for passsing arguments to functions called internally - not used at present.
A data.frame
containing the log of the likelihood ratio, its degrees of
freedom, its p-value and the number of bound parameters in each of the two models
being compared.
Self, S.G., and Liang, K-Y. (1987) Asymptotic Properties of Maximum Likelihood Estimators and Likelihood Ratio Tests Under Nonstandard Conditions. Journal of the American Statistical Association, 82, 605-10.
# NOT RUN {
REMLRT(ICV.max, ICV.red, bound.test.parameters = "onlybound")
# }
Run the code above in your browser using DataLab