corrFamily-definition {spaMM} | R Documentation |
corrFamily definition
Description
Tentative formal rules for definition of corrFamily descriptors (work in progress). This is likely to repeat and extend information partially given in corrFamily
and corrFamily-design
documentations.
User-level rules (not relevant fo corrFamily descriptors internally modified during a fit):
- tpar
-
Should always be present. For trivial parameterless cases (e.g.
ranGCA
), it should benumeric(0L)
, notNULL
. - Cf
-
function; should always be present. For trivial uncorrelated random effects (e.g.
ranGCA
, where only theAf
function carries the information for the model), it should return an identity matrix, notNULL
, with row names to be matched to the column names of the Z matrix for the random effect. - calc_moreargs
-
optional function. If present, it should have formal arguments including at least
corrfamily
and .... - Af
-
function; optional. If present, it should have row names to be matched to the column names of the Z matrix for the random effect, and also needs column names if it is to be matched with the row names of a correlation matrix (or its inverse).
- initialize
-
Optional function. If present, should have formal arguments including at least
Zmatrix
and ....In predefined corrFamily constructors, variables created by
initialize
for use byCf
orAf
should be declared (typically asNULL
) in the body of the constructor, so that R CMD check does not complain. - public
-
An environment.
initialize
may write into it. It might also read into it, for example read the result of a long previous computation byinitialize
during a previous fit, though this opens the door to various errors.