CONTRAST 'label' contrast-specification <, contrast-specification> <, …> </ options>;
The CONTRAST statement provides a mechanism for obtaining custom hypothesis tests. It is patterned after the CONTRAST statement in PROC MIXED and enables you to select an appropriate inference space (McLean, Sanders, and Stroup 1991). The GLIMMIX procedure gives you greater flexibility in entering contrast coefficients for random effects, however, because it permits the usual value-oriented positional syntax for entering contrast coefficients, as well as a level-oriented syntax that simplifies entering coefficients for interaction terms and is designed to work with constructed effects that are defined through the experimental EFFECT statement. The differences between the traditional and new-style coefficient syntax are explained in detail in the section Positional and Nonpositional Syntax for Contrast Coefficients.
You can test the hypothesis , where and , in several inference spaces. The inference space corresponds to the choice of . When , your inferences apply to the entire population from which the random effects are sampled; this is known as the broad inference space. When all elements of are nonzero, your inferences apply only to the observed levels of the random effects. This is known as the narrow inference space, and you can also choose it by specifying all of the random effects as fixed. The GLM procedure uses the narrow inference space. Finally, by zeroing portions of corresponding to selected main effects and interactions, you can choose intermediate inference spaces. The broad inference space is usually the most appropriate; it is used when you do not specify random effects in the CONTRAST statement.
In the CONTRAST statement,
identifies the contrast in the table. A label is required for every contrast specified. Labels can be up to 200 characters and must be enclosed in quotes.
identifies the fixed effects and random effects and their coefficients from which the matrix is formed. The syntax representation of a contrast-specification is < fixed-effect values …> < | random-effect values …>
identifies an effect that appears in the MODEL statement. The keyword INTERCEPT can be used as an effect when an intercept is fitted in the model. You do not need to include all effects that are in the MODEL statement.
identifies an effect that appears in the RANDOM statement. The first random effect must follow a vertical bar (|); however, random effects do not have to be specified.
are constants that are elements of the matrix associated with the fixed and random effects. There are two basic methods of specifying the entries of the matrix. The traditional representation—also known as the positional syntax—relies on entering coefficients in the position
they assume in the matrix. For example, in the following statements the elements of associated with the b
main effect receive a 1 in the first position and a –1 in the second position:
class a b; model y = a b a*b; contrast 'B at A2' b 1 -1 a*b 0 0 1 -1;
The elements associated with the interaction receive a 1 in the third position and a –1 in the fourth position. In order to
specify coefficients correctly for the interaction term, you need to know how the levels of a
and b
vary in the interaction, which is governed by the order of the variables in the CLASS
statement. The nonpositional syntax is designed to make it easier to enter coefficients for interactions and is necessary
to enter coefficients for effects constructed with the experimental EFFECT
statement. In square brackets you enter the coefficient followed by the associated levels of the CLASS
variables. If B has two and A has three levels, the previous CONTRAST statement, by using nonpositional syntax for the interaction
term, becomes
contrast 'B at A2' b 1 -1 a*b [1, 2 1] [-1, 2 2];
It assigns value 1 to the interaction where A is at level 2 and B is at level 1, and it assigns –1 to the interaction where both classification variables are at level 2. The comma separating the entry for the matrix from the level indicators is optional. Further details about the nonpositional contrast syntax and its use with constructed effects can be found in the section Positional and Nonpositional Syntax for Contrast Coefficients. Nonpositional syntax is available only for fixed-effects coefficients.
The rows of are specified in order and are separated by commas. The rows of the component of are specified on the left side of the vertical bars (|). These rows test the fixed effects and are, therefore, checked for estimability. The rows of the component of are specified on the right side of the vertical bars. They test the random effects, and no estimability checking is necessary.
If PROC GLIMMIX finds the fixed-effects portion of the specified contrast to be nonestimable (see the SINGULAR= option), then it displays missing values for the test statistics.
If the elements of are not specified for an effect that contains a specified effect, then the elements of the unspecified effect are automatically "filled in" over the levels of the higher-order effect. This feature is designed to preserve estimability for cases where there are complex higher-order effects. The coefficients for the higher-order effect are determined by equitably distributing the coefficients of the lower-level effect as in the construction of least squares means. In addition, if the intercept is specified, it is distributed over all classification effects that are not contained by any other specified effect. If an effect is not specified and does not contain any specified effects, then all of its coefficients in are set to 0. You can override this behavior by specifying coefficients for the higher-order effect.
If too many values are specified for an effect, the extra ones are ignored; if too few are specified, the remaining ones are set to 0. If no random effects are specified, the vertical bar can be omitted; otherwise, it must be present. If a SUBJECT effect is used in the RANDOM statement, then the coefficients specified for the effects in the RANDOM statement are equitably distributed across the levels of the SUBJECT effect. You can use the E option to see exactly what matrix is used.
PROC GLIMMIX handles missing level combinations of classification variables similarly to PROC GLM and PROC MIXED. These procedures delete fixed-effects parameters corresponding to missing levels in order to preserve estimability. However, PROC MIXED and PROC GLIMMIX do not delete missing level combinations for random-effects parameters, because linear combinations of the random-effects parameters are always estimable. These conventions can affect the way you specify your CONTRAST coefficients.
The CONTRAST statement computes the statistic
where , and approximates its distribution with an F distribution unless DDFM =NONE. If you select DDFM =NONE as the degrees-of-freedom method in the MODEL statement, and if you do not assign degrees of freedom to the contrast with the DF= option, then PROC GLIMMIX computes the test statistic and approximates its distribution with a chi-square distribution. In the expression for F, is an estimate of ; see the section Estimated Precision of Estimates and the section Aspects Common to Adaptive Quadrature and Laplace Approximation for details about the computation of in a generalized linear mixed model.
The numerator degrees of freedom in the F approximation and the degrees of freedom in the chi-square approximation are equal to r. The denominator degrees of freedom are taken from the "Tests of Fixed Effects" table and correspond to the final effect you list in the CONTRAST statement. You can change the denominator degrees of freedom by using the DF= option.
You can specify the following options in the CONTRAST statement after a slash (/).