naginterfaces.library.correg.lmm_​init_​combine

naginterfaces.library.correg.lmm_init_combine(hlmm, xcomm, ycomm)[source]

lmm_init_combine combines output from multiple calls to lmm_init() or mixeff_hier_init().

For full information please refer to the NAG Library document for g02jg

https://www.nag.com/numeric/nl/nagdoc_27.1/flhtml/g02/g02jgf.html

Parameters
hlmmHandle

If the two sets of communication arrays were generated using lmm_init(), then a G22 handle as generated by one of the calls to lmm_init().

If the two sets of communication arrays were generated using mixeff_hier_init(), then this argument is not referenced and need not be set.

xcommdict, communication object, modified in place

Communication structure for .

This argument must have been initialized by a prior call to lmm_init() or mixeff_hier_init().

ycommdict, communication object

Communication structure for .

This argument must have been initialized by a prior call to lmm_init() or mixeff_hier_init().

Raises
NagValueError
(errno )

has not been initialized or is corrupt.

(errno )

is not a G22 handle as generated by lmm_init().

(errno )

On entry, [‘iopts’] has not been initialized correctly.

(errno )

On entry, the information stored in [‘iopts’] and [‘iopts’] is not compatible.

(errno )

On entry, [‘iopts’] has not been initialized correctly.

Notes

Let and denote two sets of data, each with variables and and observations respectively. Let and denote two sets of communication arrays constructed by lmm_init() or mixeff_hier_init() from datasets and respectively. Then, given and , lmm_init_combine constructs a set of communication arrays, , as if a dataset , with variables and observations were supplied to lmm_init() or mixeff_hier_init(), with constructed as

Splitting, and then recombining, the data in this manner allows for datasets with an arbitrarily large number of observations () to be analysed and the preprocessing routines, lmm_init() or mixeff_hier_init(), to be run in parallel.

It should be noted that, while the information in , should be consistent with the information in the communication arrays obtained by supplying to lmm_init() or mixeff_hier_init(), the ordering of that information may change. In practice, this means that whilst an analysis run using a set of communication arrays constructed using lmm_init_combine should give similar results to an analysis run using a set of communication arrays constructed directly from lmm_init() or mixeff_hier_init() they will not necessarily be identical. In addition, the order of the parameter estimates, and may differ.