The BGLIMM Procedure

RANDOM Statement

  • RANDOM random-effects </ options>;

Using notation from the section Notation for the Generalized Linear Mixed Model, the RANDOM statement defines the bold upper Z matrix of the mixed model, the random effects in the bold-italic gamma vector, and the covariance structure of bold upper G.

The bold upper Z matrix is constructed exactly like the bold upper X matrix for the fixed effects, and the bold upper G matrix is constructed to correspond to the effects that constitute bold upper Z. The covariance structure of bold upper G is defined by using the TYPE= option. The random effects can be classification or continuous effects, and you can specify multiple RANDOM statements.

You can specify INTERCEPT (or INT) as a random effect to indicate the intercept. PROC BGLIMM does not include the intercept in the RANDOM statement by default as it does in the MODEL statement.

Table 9 summarizes the options available in the RANDOM statement. All options are then discussed in alphabetical order.

Table 9: RANDOM Statement Options

Option Description
Construction and Sampling of Covariance Structure
COVPRIOR= Specifies the prior for the bold upper G matrix
GROUP= Varies the bold upper G covariance matrix by group
NUTS Specifies options for the No-U-Turn Sampler of the Hamiltonian
Monte Carlo algorithm for the bold upper G matrix
RESIDUAL Designates a covariance structure as R-side
SUBJECT= Identifies the subjects in the model
TYPE= Specifies the type of the bold upper G matrix
Statistical Output
G Displays the estimated bold upper G matrix
GCORR Displays the correlation matrix that corresponds to the estimated bold upper G matrix
MONITOR Displays the summary, diagnostic statistics, and plots
of individual random effects
NOOUTPOST Suppresses storing the posterior samples of
individual random effects in the OUTPOST= data set


You can specify the following options in the RANDOM statement after a slash (/).

COVPRIOR=prior-distribution

specifies a prior distribution for the covariance matrix, bold upper G, of the random effects, when the bold upper G matrix is of the UN, UN(1), VC, or TOEP(1) type, where a conjugate sampler is used to sample the covariance matrix. This option is ignored for other covariance types, because you assign a flat prior to the bold upper G matrix if its type is not UN, UN(1), VC, or TOEP(1). For more information, see the section Prior for the G-Side Covariance.

You can specify one of the following prior-distributions:

HALFCAUCHY <(SCALE=a)>
HCAUCHY <(SCALE=a)>
HC <(SCALE=a)>

specifies the prior to be a half-Cauchy distribution. The half-Cauchy prior is applied only to the diagonal terms (variances) of the bold upper G matrix. The off-diagonal terms of the bold upper G matrix are assumed to have a flat prior.

You can specify the scale parameter a of the half-Cauchy distribution. The scale parameter a must be positive. By default, SCALE=25.

HALFNORMAL <(VAR=a)>
HNORMAL <(VAR=a)>
HN <(VAR=a)>

specifies the prior to be a half-normal distribution. The half-normal prior is applied only to the diagonal terms (variances) of the bold upper G matrix. The off-diagonal terms of the bold upper G matrix are assumed to have a flat prior.

You can specify the variance a of the half-normal distribution. The variance a must be positive. By default, VAR=25.

IGAMMA <(options)>

specifies an inverse gamma prior, normal upper I normal upper G left-parenthesis a comma b right-parenthesis, with the density f left-parenthesis t right-parenthesis equals StartFraction b Superscript a Baseline Over normal upper Gamma left-parenthesis a right-parenthesis EndFraction t Superscript minus left-parenthesis a plus 1 right-parenthesis Baseline normal e Superscript negative b slash t for each diagonal term of the bold upper G matrix. It is the default prior for the covariance types UN(1), VC, and TOEP(1).

You can set the parameters of the inverse gamma distribution by specifying one or both of the following options, separated by a comma or a space:

SHAPE=a

specifies the shape parameter a of the inverse gamma distribution. By default, SHAPE=2.

SCALE=b

specifies the scale parameter b of the inverse gamma distribution. BY default, SCALE=2.

IWISHART <(options)>
IWISH <(options)>
IW <(options)>

specifies an inverse Wishart prior, normal upper I normal upper W normal upper I normal upper S normal upper H normal upper A normal upper R normal upper T left-parenthesis a comma bold upper S right-parenthesis, for the bold upper G matrix of the random effects. The hyperparameters a and bold upper S are the degrees of freedom and scale matrix of an inverse Wishart distribution, respectively. The inverse Wishart prior is the default prior for the UN covariance type. The following examples show several ways to specify an inverse Wishart prior distribution:

covprior=iwishart covprior=iwishart(scale=25) covprior=iwishart(df=6, diagonal=(1 4 9))

You can set the parameters of the inverse Wishart distribution by specifying one or more of the following options, separated by a comma or a space:

DF=a

specifies the degrees of freedom of the inverse Wishart distribution. The default is the dimension of the bold upper G matrix plus 3.

SCALE=b

specifies bold upper S equals b bold upper I as the scale matrix of the inverse Wishart distribution, where bold upper I is the identity matrix. The default is the dimension of the bold upper G matrix plus 3. You can set the scale matrix bold upper S by specifying one of these options: SCALE=, DIAGONAL=, or COV=.

DIAGONAL=numeric-list

specifies a list of positive values for the diagonal terms in the scale matrix bold upper S of the inverse Wishart distribution. The default value of each diagonal term is the dimension of the bold upper G matrix plus 3. You can set the scale matrix bold upper S by specifying one of these options: SCALE=, DIAGONAL=, or COV=.

COV=numeric-list

specifies a list of values for the entries in the lower-triangle portion of the scale matrix bold upper S for the inverse Wishart distribution. The specified values of the diagonal terms must be positive, and the whole matrix must be positive definite. The order of the list is rowwise. The default setting is bold upper S equals b bold upper I, where b is the dimension of the bold upper G matrix plus 3. You can set the scale matrix bold upper S by specifying one of these options: SCALE=, DIAGONAL=, or COV=.

SIWISHART <(options)>
SIWISH <(options)>
SIW <(options)>

specifies a scaled inverse Wishart prior for the bold upper G matrix of the random effects.

You can set the parameters of the scaled inverse Wishart distribution by specifying one or more of the following options, separated by a comma or a space:

DF=a

specifies the degrees of freedom a of the scaled inverse Wishart distribution. The default is the dimension of the bold upper G matrix of the random effects plus 3.

SCALE=b

specifies b bold upper I as the scale matrix of the scaled inverse Wishart distribution, where bold upper I is the identity matrix. The default is the dimension of the bold upper G matrix of the random effects plus 3.

VAR=c

specifies the variance parameter c of the normal prior for log left-parenthesis delta Subscript i Baseline right-parenthesis. By default, VAR=1.

UNIFORM <(options)>
UNIF <(options)>

specifies a uniform prior, normal upper U normal upper N normal upper I normal upper F normal upper O normal upper R normal upper M left-parenthesis a comma b right-parenthesis, for the bold upper G matrix of the random effects. The uniform prior is applied to standard deviations (the square root of the diagonal terms) of the bold upper G matrix.

You can set the lower and upper bounds of the uniform distribution by specifying one or both of the following options, separated by a comma or a space:

LOWER=a

specifies the lower bound a of the uniform distribution. The lower bound must be nonnegative. By default, LOWER=0.

UPPER=b

specifies the upper bound b of the uniform distribution. The upper bound must be positive. By default, UPPER=1E10.

G

displays the estimated bold upper G matrix for G-side random effects that are associated with this RANDOM statement. PROC BGLIMM displays blanks for values that are 0. The ODS table name is G.

GCORR

displays the correlation matrix that corresponds to the estimated bold upper G matrix for G-side random effects that are associated with this RANDOM statement. PROC BGLIMM displays blanks for values that are 0. The ODS table name is GCORR.

GROUP=effect
GRP=effect

identifies groups by which to vary the covariance parameters. All observations that have the same level of the effect have the same covariance parameters. Each new level of the grouping effect produces a new set of covariance parameters. You should exercise caution in properly defining the effect, because strange covariance patterns can result when it is misused. Also, the effect can greatly increase the number of estimated covariance parameters, which can adversely affect the sampling process.

The GROUP= effect must be specified in the CLASS statement.

MONITOR<=(numeric-list | RANDOM (number))>
SOLUTION<=(numeric-list | RANDOM (number))>
S<=(numeric-list | RANDOM (number))>

displays results (summary, diagnostic statistics, and plots) for the individual-level random-effects parameters. By default, to save time and space, PROC BGLIMM does not print results for individual-level random-effects parameters. In models that have a large number of individual random effects (for example, tens of thousands), it can take a long time to display the summary, diagnostic statistics, and plots for all the individual-level parameters, so be cautious when using this option.

You can monitor a subset of the random-effects parameters. You can provide a numeric list of the SUBJECT indexes, or PROC BGLIMM can randomly choose a subset of all subjects for you.

To monitor a list of random-effects parameters for certain subjects, you can provide their indexes as follows:

random x / subject=index monitor=(1 to 5 by 2 23 57);

In this case, PROC BGLIMM outputs results of random effects for subjects 1, 3, 5, 23, and 57. If the number of items in the list is greater than the number of subjects, the extra list items are ignored.

PROC BGLIMM can also randomly choose a subset of all the subjects to monitor, if you submit a statement such as the following:

random x / subject=index monitor=(random(12));

In this case, PROC BGLIMM outputs results of random effects for 12 randomly selected subjects. You control the sequence of the random indexes by specifying the SEED= option in the PROC BGLIMM statement.

When you specify the MONITOR option, it uses the values that you specify in the STATISTICS= and PLOTS= options in the PROC BGLIMM statement.

NOOUTPOST

suppresses storing the posterior samples of individual random-effects parameters in the OUTPOST= data set. By default, PROC BGLIMM outputs the posterior samples of all random-effects parameters to the OUTPOST= data set. You can use this option to avoid saving the random-effects parameters. In models that have a large number of individual random effects (for example, tens of thousands), PROC BGLIMM can run faster if it does not save the posterior samples of all the individual random effects.

When you specify both the NOOUTPOST option and the MONITOR option, PROC BGLIMM outputs the list of variables that are monitored.

There is a limit on the maximum number of variables that you can save to an OUTPOST= data set. If you run a large-scale random-effects model in which the number of parameters exceeds that limit, the NOOUTPOST option is invoked automatically and PROC BGLIMM does not save the individual random-effects draws to the output data set. You can use the MONITOR option to select a subset of the parameters to store in the OUTPOST= data set.

NUTS<(nuts-options)>

specifies options for the No-U-Turn Sampler (NUTS) of the Hamiltonian algorithm that is used to sample the parameters in the bold upper G matrix of the corresponding RANDOM statement. The NUTS algorithm is a version of the adaptive Hamiltonian Monte Carlo algorithm with automatic tuning of the step size and number of steps in each iteration. For more information, see the section Hamiltonian Monte Carlo Sampler. You can specify the following nuts-options:

DELTA=value

specifies the target acceptance rate during the tuning process of the NUTS algorithm. Increasing the value can often improve mixing, but it can also significantly slow down the sampling. By default, DELTA=0.6.

MAXHEIGHT=value

specifies the maximum height of the NUTS algorithm tree. The taller the tree, the more gradient evaluations per iteration the procedure calculates. The number of evaluations is 2 Superscript height. Usually, the height of a tree should be no more than 10 during the sampling stage, but it can go higher during the tuning stage. A larger number indicates that the algorithm is having difficulty converging. By default, MAXHEIGHT=10.

NTU=value

specifies the number of tuning iterations for the NUTS algorithm to use. By default, NTU=1000.

STEPSIZE=value

specifies the initial step size in the NUTS algorithm. By default, STEPSIZE=0.1.

RESIDUAL
RSIDE

specifies that the random effects listed in this statement be R-side effects. You use this option in the RANDOM statement if the covariance matrix is for the R-side. Specifying this option is equivalent to using the REPEATED statement. For example, if it is necessary to order the columns of the R-side AR(1) covariance structure by the Time variable, you can use the RESIDUAL option as in the following statements:

class time id;
random time / subject=id type=ar(1) residual;
SUBJECT=effect
SUB=effect

identifies the subjects in the model for the random effects.

A set of random effects is estimated for each subject. All variables in the effect must be declared as categorical variables in the CLASS statement. PROC BGLIMM assumes independence across subjects, conditional on other parameters in the model. Specifying a subject effect is equivalent to nesting all other effects in the RANDOM statement within the subject effect. Thus, for the RANDOM statement, the SUBJECT= option produces a block-diagonal structure that has identical blocks.

For more information about specifying a random effect with or without the SUBJECT= variable, see the section Treatment of Subjects in the RANDOM Statement.

TYPE=covariance-structure

specifies the covariance structure of the bold upper G matrix for G-side effects.

Although a variety of structures are available, many applications call for either simple diagonal (TYPE=VC) or unstructured covariance matrices. The default structure is TYPE=VC (variance components), which models a different variance component for each random effect.

If you want different covariance structures in different parts of bold upper G, you must use multiple RANDOM statements with different TYPE= options.

Valid values for covariance-structure and their descriptions are provided in Table 10.

Table 10: Covariance Structures

Structure Description Parms left-parenthesis i comma j right-parenthesis Element
ANTE(1) Antedependence 2 t minus 1 sigma Subscript i Baseline sigma Subscript j Baseline product Underscript k equals i Overscript j minus 1 Endscripts rho Subscript k
AR(1) Autoregressive(1) 2 sigma squared rho Superscript StartAbsoluteValue i minus j EndAbsoluteValue
ARH(1) Heterogeneous AR(1) t plus 1 sigma Subscript i Baseline sigma Subscript j Baseline rho Superscript StartAbsoluteValue i minus j EndAbsoluteValue
ARMA(1,1) ARMA(1,1) 3 sigma squared left-bracket gamma rho Superscript StartAbsoluteValue i minus j EndAbsoluteValue minus 1 Baseline Baseline 1 left-parenthesis i not-equals j right-parenthesis plus 1 left-parenthesis i equals j right-parenthesis right-bracket
CS Compound symmetry 2 sigma 1 plus sigma squared 1 left-parenthesis i equals j right-parenthesis
CSH Heterogeneous compound symmetry t plus 1 sigma Subscript i Baseline sigma Subscript j Baseline left-bracket rho Baseline 1 left-parenthesis i not-equals j right-parenthesis plus 1 left-parenthesis i equals j right-parenthesis right-bracket
FA(1) Factor analytic 2 t lamda Subscript i Baseline lamda Subscript j plus d Subscript i Baseline 1 left parenthesis i equals j right parenthesis
HF Huynh-Feldt t plus 1 left-parenthesis sigma Subscript i Superscript 2 Baseline plus sigma Subscript j Superscript 2 Baseline right-parenthesis slash 2 minus lamda Baseline 1 left-parenthesis i not-equals j right-parenthesis
TOEP Toeplitz t sigma Subscript StartAbsoluteValue i minus j EndAbsoluteValue plus 1
TOEP(q) Banded Toeplitz q sigma Subscript StartAbsoluteValue i minus j EndAbsoluteValue plus 1 Baseline 1 left-parenthesis StartAbsoluteValue i minus j EndAbsoluteValue less-than q right-parenthesis
TOEPH Heterogeneous Toeplitz 2 t minus 1 sigma Subscript i Baseline sigma Subscript j Baseline rho Subscript StartAbsoluteValue i minus j EndAbsoluteValue
TOEPH(q) Banded heterogeneous Toeplitz t plus q minus 1 sigma Subscript i Baseline sigma Subscript j Baseline rho Subscript StartAbsoluteValue i minus j EndAbsoluteValue Baseline 1 left-parenthesis StartAbsoluteValue i minus j EndAbsoluteValue less-than q right-parenthesis
UN Unstructured t left-parenthesis t plus 1 right-parenthesis slash 2 sigma Subscript i j
UN(q) Banded StartFraction q Over 2 EndFraction left-parenthesis 2 t minus q plus 1 right-parenthesis sigma Subscript i j Baseline 1 left-parenthesis StartAbsoluteValue i minus j EndAbsoluteValue less-than q right-parenthesis
VC Variance components q sigma Subscript k Superscript 2 Baseline 1 left-parenthesis i equals j right-parenthesis
and i corresponds to kth effect


In Table 10, Parms refers to the number of covariance parameters in the structure, t is the overall dimension of the covariance matrix, q is the order parameter, and 1 left-parenthesis upper A right-parenthesis equals 1 when A is true and 0 otherwise. For example, 1left-parenthesis i equals j right-parenthesis equals 1 when i equals j and 0 otherwise, and 1left-parenthesis StartAbsoluteValue i minus j EndAbsoluteValue less-than q right-parenthesis equals 1 when StartAbsoluteValue i minus j EndAbsoluteValue less-than q and 0 otherwise. For the TYPE=TOEPH structures, rho 0 equals 1.

ANTE(1)

specifies a first-order antedependence structure (Kenward 1987; Patel 1991) parameterized in terms of variances and correlation parameters. If t ordered random variables xi 1 comma ellipsis comma xi Subscript t Baseline have a first-order antedependence structure, then each xi Subscript j, j greater-than 1, is independent of all other xi Subscript k Baseline comma k less-than j, given xi Subscript j minus 1. This Markovian structure is characterized by its inverse variance matrix, which is tridiagonal. Parameterizing an ANTE(1) structure for a random vector of size t requires 2t – 1 parameters: variances sigma 1 squared comma ellipsis comma sigma Subscript t Superscript 2 and t – 1 correlation parameters rho 1 comma ellipsis comma rho Subscript t minus 1 Baseline. The covariances among random variables xi Subscript i and xi Subscript j are then constructed as

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartRoot sigma Subscript i Superscript 2 Baseline sigma Subscript j Superscript 2 Baseline EndRoot product Underscript k equals i Overscript j minus 1 Endscripts rho Subscript k

PROC BGLIMM constrains the correlation parameters to satisfy StartAbsoluteValue rho Subscript k Baseline EndAbsoluteValue less-than 1 comma for-all k. For variable-order antedependence models see Macchiavelli and Arnold (1994).

AR(1)

specifies a first-order autoregressive structure,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals sigma squared rho Superscript StartAbsoluteValue i Super Superscript asterisk Superscript minus j Super Superscript asterisk Superscript EndAbsoluteValue

The values i Superscript asterisk and j Superscript asterisk are derived for the ith and jth observations, respectively, and are not necessarily the observation numbers. For example, in the following statements, the values correspond to the class levels for the Time effect of the ith and jth observation within a particular subject:

proc bglimm;
   class time patient;
   model y = x x*x;
   random time / sub=patient type=ar(1);
run;

PROC BGLIMM imposes the constraint StartAbsoluteValue rho EndAbsoluteValue less-than 1 for stationarity.

ARH(1)

specifies a heterogeneous first-order autoregressive structure,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartRoot sigma Subscript i Superscript 2 Baseline sigma Subscript j Superscript 2 Baseline EndRoot rho Superscript StartAbsoluteValue i Super Superscript asterisk Superscript minus j Super Superscript asterisk Superscript EndAbsoluteValue

where StartAbsoluteValue rho EndAbsoluteValue less-than 1. This covariance structure has the same correlation pattern as the TYPE=AR(1) structure, but the variances are allowed to differ.

ARMA(1,1)

specifies the first-order autoregressive moving average structure,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma squared 2nd Column i equals j 2nd Row 1st Column sigma squared gamma rho Superscript StartAbsoluteValue i Super Superscript asterisk Superscript minus j Super Superscript asterisk Superscript EndAbsoluteValue minus 1 Baseline 2nd Column i not-equals j EndLayout

Here, rho is the autoregressive parameter, gamma models a moving average component, and sigma squared is a scale parameter. In the notation of Fuller (1976, p. 68), rho equals theta 1 and

gamma equals StartFraction left-parenthesis 1 plus b 1 theta 1 right-parenthesis left-parenthesis theta 1 plus b 1 right-parenthesis Over 1 plus b 1 squared plus 2 b 1 theta 1 EndFraction

The example in Table 11 and StartAbsoluteValue b 1 EndAbsoluteValue less-than 1 imply that

b 1 equals StartFraction beta minus StartRoot beta squared minus 4 alpha squared EndRoot Over 2 alpha EndFraction

where alpha equals gamma minus rho and beta equals 1 plus rho squared minus 2 gamma rho. PROC BGLIMM imposes the constraints StartAbsoluteValue rho EndAbsoluteValue less-than 1 and StartAbsoluteValue gamma EndAbsoluteValue less-than 1 for stationarity, although for some values of rho and gamma in this region, the resulting covariance matrix is not positive definite.

CS

specifies the compound symmetry structure, which has constant variance and constant covariance

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma 1 plus sigma squared 2nd Column i equals j 2nd Row 1st Column sigma 1 2nd Column i not-equals j EndLayout

The compound symmetry structure arises naturally with nested random effects, such as when subsampling error is nested within experimental error. Hierarchical random assignments or selections, such as subsampling or split-plot designs, give rise to compound symmetric covariance structures. This implies exchangeability of the observations in the subunit, leading to constant correlations between the observations. Compound symmetry structures are thus usually not appropriate for processes in which correlations decline according to some metric, such as spatial and temporal processes.

CSH

specifies the heterogeneous compound symmetry structure, which is an equicorrelation structure but allows for different variances,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column StartRoot sigma Subscript i Superscript 2 Baseline sigma Subscript j Superscript 2 Baseline EndRoot 2nd Column i equals j 2nd Row 1st Column rho StartRoot sigma Subscript i Superscript 2 Baseline sigma Subscript j Superscript 2 Baseline EndRoot 2nd Column i not-equals j EndLayout
FA(1)

specifies the factor-analytic structure with one factor (Jennrich and Schluchter 1986). This structure is of the form bold italic lamda bold italic lamda prime plus bold upper D, where bold italic lamda is a t times 1 vector and bold upper D is a t times t diagonal matrix with t different parameters.

HF

specifies a covariance structure that satisfies the general Huynh-Feldt condition (Huynh and Feldt 1970). For a random vector that has t elements, this structure has t plus 1 positive parameters and covariances

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma Subscript i Superscript 2 Baseline 2nd Column i equals j 2nd Row 1st Column 0.5 left-parenthesis sigma Subscript i Superscript 2 Baseline plus sigma Subscript j Superscript 2 Baseline right-parenthesis minus lamda 2nd Column i not-equals j EndLayout

A covariance matrix bold upper Sigma generally satisfies the Huynh-Feldt condition if it can be written as bold upper Sigma equals bold-italic tau bold 1 Superscript prime Baseline plus bold 1 bold-italic tau Superscript prime Baseline plus lamda bold upper I. The preceding parameterization chooses tau Subscript i Baseline equals 0.5 left-parenthesis sigma Subscript i Superscript 2 Baseline minus lamda right-parenthesis. Several simpler covariance structures give rise to covariance matrices that also satisfy the Huynh-Feldt condition. For example, TYPE=CS, VC, and UN(1) are nested within TYPE=HF. Note also that the HF structure is nested within an unstructured covariance matrix.

TOEP

models a Toeplitz covariance structure. This structure can be viewed as an autoregressive structure whose order is equal to the dimension of the matrix,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma squared 2nd Column i equals j 2nd Row 1st Column sigma Subscript StartAbsoluteValue i minus j EndAbsoluteValue Baseline 2nd Column i not-equals j EndLayout
TOEP(q)

specifies a banded Toeplitz structure,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma squared 2nd Column i equals j 2nd Row 1st Column sigma Subscript StartAbsoluteValue i minus j EndAbsoluteValue Baseline 2nd Column StartAbsoluteValue i minus j EndAbsoluteValue less-than q EndLayout

This can be viewed as a moving average structure whose order is equal to q – 1. The specification TYPE=TOEP(1) is the same as sigma squared bold upper I, and it can be useful for specifying the same variance component for several effects.

TOEPH<(q)>

models a Toeplitz covariance structure. The correlations of this structure are banded as in the TOEP or TOEP(q) structures, but the variances are allowed to vary:

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals StartLayout Enlarged left-brace 1st Row 1st Column sigma Subscript i Superscript 2 Baseline 2nd Column i equals j 2nd Row 1st Column rho Subscript StartAbsoluteValue i minus j EndAbsoluteValue Baseline StartRoot sigma Subscript i Superscript 2 Baseline sigma Subscript j Superscript 2 Baseline EndRoot 2nd Column i not-equals j EndLayout

The correlation parameters satisfy StartAbsoluteValue rho Subscript StartAbsoluteValue i minus j EndAbsoluteValue Baseline EndAbsoluteValue less-than 1. If you specify the optional value q, the correlation parameters with StartAbsoluteValue i minus j EndAbsoluteValue greater-than-or-equal-to q are set to 0, creating a banded correlation structure. The specification TYPE=TOEPH(1) results in a diagonal covariance matrix with heterogeneous variances.

UN<(q)>

specifies a completely general (unstructured) covariance matrix that is parameterized directly in terms of variances and covariances,

normal upper C normal o normal v left-bracket xi Subscript i Baseline comma xi Subscript j Baseline right-bracket equals sigma Subscript i j

The variances are constrained to be nonnegative, and the covariances are unconstrained. This structure is constrained to be nonnegative definite. If you specify the order parameter q, then PROC BGLIMM estimates only the first q bands of the matrix, setting elements in all higher bands equal to 0.

VC

specifies standard variance components and is the default structure for both G-side and R-side covariance structures. In a G-side covariance structure, a distinct variance component is assigned to each effect. In an R-side structure, TYPE=VC is usually used only to add overdispersion effects or, with the GROUP= option, to specify a heterogeneous variance model.

Table 11 lists some examples of the structures in Table 10.

Table 11: Covariance Structure Examples

Description Structure Example
First-order
antedependence
ANTE(1) Start 3 By 3 Matrix 1st Row 1st Column sigma 1 squared 2nd Column sigma 1 sigma 2 rho 1 3rd Column sigma 1 sigma 3 rho 1 rho 2 2nd Row 1st Column sigma 2 sigma 1 rho 1 2nd Column sigma 2 squared 3rd Column sigma 2 sigma 3 rho 2 3rd Row 1st Column sigma 3 sigma 1 rho 2 rho 1 2nd Column sigma 3 sigma 2 rho 2 3rd Column sigma 3 squared EndMatrix
First-order
autoregressive
AR(1) sigma squared Start 4 By 4 Matrix 1st Row 1st Column 1 2nd Column rho 3rd Column rho squared 4th Column rho cubed 2nd Row 1st Column rho 2nd Column 1 3rd Column rho 4th Column rho squared 3rd Row 1st Column rho squared 2nd Column rho 3rd Column 1 4th Column rho 4th Row 1st Column rho cubed 2nd Column rho squared 3rd Column rho 4th Column 1 EndMatrix
Heterogeneous
AR(1)
ARH(1) Start 4 By 4 Matrix 1st Row 1st Column sigma 1 squared 2nd Column sigma 1 sigma 2 rho 3rd Column sigma 1 sigma 3 rho squared 4th Column sigma 1 sigma 4 rho cubed 2nd Row 1st Column sigma 2 sigma 1 rho 2nd Column sigma 2 squared 3rd Column sigma 2 sigma 3 rho 4th Column sigma 2 sigma 4 rho squared 3rd Row 1st Column sigma 3 sigma 1 rho squared 2nd Column sigma 3 sigma 2 rho 3rd Column sigma 3 squared 4th Column sigma 3 sigma 4 rho 4th Row 1st Column sigma 4 sigma 1 rho cubed 2nd Column sigma 4 sigma 2 rho 3rd Column sigma 4 sigma 3 rho 4th Column sigma 4 squared EndMatrix
First-order
autoregressive
moving average
ARMA(1,1) sigma squared Start 4 By 4 Matrix 1st Row 1st Column 1 2nd Column gamma 3rd Column gamma rho 4th Column gamma rho squared 2nd Row 1st Column gamma 2nd Column 1 3rd Column gamma 4th Column gamma rho 3rd Row 1st Column gamma rho 2nd Column gamma 3rd Column 1 4th Column gamma 4th Row 1st Column gamma rho squared 2nd Column gamma rho 3rd Column gamma 4th Column 1 EndMatrix
Compound
symmetry
CS Start 4 By 4 Matrix 1st Row 1st Column sigma 1 plus sigma squared 2nd Column sigma 1 3rd Column sigma 1 4th Column sigma 1 2nd Row 1st Column sigma 1 2nd Column sigma 1 plus sigma squared 3rd Column sigma 1 4th Column sigma 1 3rd Row 1st Column sigma 1 2nd Column sigma 1 3rd Column sigma 1 plus sigma squared 4th Column sigma 1 4th Row 1st Column sigma 1 2nd Column sigma 1 3rd Column sigma 1 4th Column sigma 1 plus sigma squared EndMatrix
Heterogeneous
compound symmetry
CSH Start 4 By 4 Matrix 1st Row 1st Column sigma 1 squared 2nd Column sigma 1 sigma 2 rho 3rd Column sigma 1 sigma 3 rho 4th Column sigma 1 sigma 4 rho 2nd Row 1st Column sigma 2 sigma 1 rho 2nd Column sigma 2 squared 3rd Column sigma 2 sigma 3 rho 4th Column sigma 2 sigma 4 rho 3rd Row 1st Column sigma 3 sigma 1 rho 2nd Column sigma 3 sigma 2 rho 3rd Column sigma 3 squared 4th Column sigma 3 sigma 4 rho 4th Row 1st Column sigma 4 sigma 1 rho 2nd Column sigma 4 sigma 2 rho 3rd Column sigma 4 sigma 3 rho 4th Column sigma 4 squared EndMatrix
First-order
factor
analytic
FA(1) Start 4 By 4 Matrix 1st Row 1st Column lamda 1 squared plus d 1 2nd Column lamda 1 lamda 2 3rd Column lamda 1 lamda 3 4th Column lamda 1 lamda 4 2nd Row 1st Column lamda 2 lamda 1 2nd Column lamda 2 squared plus d 2 3rd Column lamda 2 lamda 3 4th Column lamda 2 lamda 4 3rd Row 1st Column lamda 3 lamda 1 2nd Column lamda 3 lamda 2 3rd Column lamda 3 squared plus d 3 4th Column lamda 3 lamda 4 4th Row 1st Column lamda 4 lamda 1 2nd Column lamda 4 lamda 2 3rd Column lamda 4 lamda 3 4th Column lamda 4 squared plus d 4 EndMatrix
Huynh-Feldt HF Start 3 By 3 Matrix 1st Row 1st Column sigma 1 squared 2nd Column StartFraction sigma 1 squared plus sigma 2 squared Over 2 EndFraction minus lamda 3rd Column StartFraction sigma 1 squared plus sigma 3 squared Over 2 EndFraction minus lamda 2nd Row 1st Column StartFraction sigma 2 squared plus sigma 1 squared Over 2 EndFraction minus lamda 2nd Column sigma 2 squared 3rd Column StartFraction sigma 2 squared plus sigma 3 squared Over 2 EndFraction minus lamda 3rd Row 1st Column StartFraction sigma 3 squared plus sigma 1 squared Over 2 EndFraction minus lamda 2nd Column StartFraction sigma 3 squared plus sigma 2 squared Over 2 EndFraction minus lamda 3rd Column sigma 3 squared EndMatrix
Toeplitz TOEP Start 4 By 4 Matrix 1st Row 1st Column sigma squared 2nd Column sigma 1 3rd Column sigma 2 4th Column sigma 3 2nd Row 1st Column sigma 1 2nd Column sigma squared 3rd Column sigma 1 4th Column sigma 2 3rd Row 1st Column sigma 2 2nd Column sigma 1 3rd Column sigma squared 4th Column sigma 1 4th Row 1st Column sigma 3 2nd Column sigma 2 3rd Column sigma 1 4th Column sigma squared EndMatrix
Toeplitz with
two bands
TOEP(2) Start 4 By 4 Matrix 1st Row 1st Column sigma squared 2nd Column sigma 1 3rd Column 0 4th Column 0 2nd Row 1st Column sigma 1 2nd Column sigma squared 3rd Column sigma 1 4th Column 0 3rd Row 1st Column 0 2nd Column sigma 1 3rd Column sigma squared 4th Column sigma 1 4th Row 1st Column 0 2nd Column 0 3rd Column sigma 1 4th Column sigma squared EndMatrix
Heterogeneous
Toeplitz
TOEPH Start 4 By 4 Matrix 1st Row 1st Column sigma 1 squared 2nd Column sigma 1 sigma 2 rho 1 3rd Column sigma 1 sigma 3 rho 2 4th Column sigma 1 sigma 4 rho 3 2nd Row 1st Column sigma 2 sigma 1 rho 1 2nd Column sigma 2 squared 3rd Column sigma 2 sigma 3 rho 1 4th Column sigma 2 sigma 4 rho 2 3rd Row 1st Column sigma 3 sigma 1 rho 2 2nd Column sigma 3 sigma 2 rho 1 3rd Column sigma 3 squared 4th Column sigma 3 sigma 4 rho 1 4th Row 1st Column sigma 4 sigma 1 rho 3 2nd Column sigma 4 sigma 2 rho 2 3rd Column sigma 4 sigma 3 rho 1 4th Column sigma 4 squared EndMatrix
Unstructured UN Start 4 By 4 Matrix 1st Row 1st Column sigma 1 squared 2nd Column sigma 21 3rd Column sigma 31 4th Column sigma 41 2nd Row 1st Column sigma 21 2nd Column sigma 2 squared 3rd Column sigma 32 4th Column sigma 42 3rd Row 1st Column sigma 31 2nd Column sigma 32 3rd Column sigma 3 squared 4th Column sigma 43 4th Row 1st Column sigma 41 2nd Column sigma 42 3rd Column sigma 43 4th Column sigma 4 squared EndMatrix
Banded main
diagonal
UN(1) Start 4 By 4 Matrix 1st Row 1st Column sigma 1 squared 2nd Column 0 3rd Column 0 4th Column 0 2nd Row 1st Column 0 2nd Column sigma 2 squared 3rd Column 0 4th Column 0 3rd Row 1st Column 0 2nd Column 0 3rd Column sigma 3 squared 4th Column 0 4th Row 1st Column 0 2nd Column 0 3rd Column 0 4th Column sigma 4 squared EndMatrix
Variance
components
VC (default) Start 4 By 4 Matrix 1st Row 1st Column sigma Subscript upper B Superscript 2 2nd Column 0 3rd Column 0 4th Column 0 2nd Row 1st Column 0 2nd Column sigma Subscript upper B Superscript 2 3rd Column 0 4th Column 0 3rd Row 1st Column 0 2nd Column 0 3rd Column sigma Subscript upper A upper B Superscript 2 4th Column 0 4th Row 1st Column 0 2nd Column 0 3rd Column 0 4th Column sigma Subscript upper A upper B Superscript 2 EndMatrix


Last updated: December 09, 2022