Performs a multi-treatment meta analysis using summary results from individual experiments (V.M. Cave).
Options
PRINT = string tokens |
Controls printed output from the REML analysis (model , components , effects , means , monitoring , vcovariance , deviance , Waldtests , covariancemodels ); default mode , comp , cova , mean |
PSE = string token |
Standard errors to be printed with tables of effects and means (differences , estimates , alldifferences , allestimates , none ); default alle |
EMETHOD = string token |
Specifies whether the EXPERIMENTS main effect is fitted as a fixed or random term in the REML model; default fixe |
VCMODEL = string token |
Specifies the between-experiment variance-covariance model (identity , diagonal , cs , hcs , unstructured , faequal1 , faequal2 , fa1 ); default iden for fixed EXPERIMENTS effects and cs for random effects |
INITIAL = scalars, variates, matrices, symmetric matrices or pointers |
Initial parameter values for the variance-covariance model specified by VCMODEL (supplied in the structures appropriate for the model concerned); default generates values automatically |
MAXCYCLE = scalar |
Sets a limit on the number of iterations in the REML analysis; default 30 |
Parameters
MEANS = variates |
Supplies the TREATMENTS by EXPERIMENTS means |
TREATMENTS = factors |
Identifier of the treatments factor |
EXPERIMENTS = factors |
Identifier of the experiments factor |
SEDMEANS = variates |
Supplies the (average) standard error of differences in each experiment |
VARIANCES = variates |
Identifier for the variate containing the sampling variance for each experiment |
MODERATOR = factors or variates |
Identifier for a moderator variable |
SAVE = REML save structures |
Saves the details of each analysis for use in subsequent VDISPLAY and VKEEP directives |
Description
VMETA
uses REML
to perform a multi-treatment meta analysis, when only the summary results for each treatment (i.e. means and standard error of the difference or sampling variance) are available from the individual experiments. The estimated treatment means for each experiment are supplied, in a variate, using the MEANS
parameter. The TREATMENTS
and EXPERIMENTS
parameters must specify factors indicating the treatment and experiment, respectively, corresponding to each mean.
You must use either the SEDMEANS
parameter to supply the (average) standard error of differences for the experiments, or the VARIANCES
parameter to supply their sampling variances. You can specify these in a variate with the same length as the number of experiments. Alternatively, you can supply them in a variate with the same length as MEANS
. However, this must contain the same value for the treatments in each experiment.
The EMETHOD
option specifies whether the experiment effects are fitted as fixed or random; default fixed. The VCMODEL
option specifies the variance-covariance structure used to model the variation and correlation of the between-experiment treatment effects. (See the Method Section below for details.) The variance-covariance models available depend on the EMETHOD
option. When EMETHOD=fixed
, the possibilities are identity (default) and diagonal. When EMETHOD=random
, they are cs
(default), hcs
, unstructured
, faequal1
, faequal2
and fa1
. Initial values for the parameters of the variance-covariance model can be supplied by the INITIAL option, which corresponds to the INITIAL
parameter of the VSTRUCTURE
directive. Default values are generated automatically. For all models, except unstructured, the number of initial values is the number of parameters. However, for the unstructured model, a full covariance matrix of initial values must be given. The initial values must be supplied in the structures appropriate for the model concerned. See the VSTRUCTURE
directive for details.
The MODERATOR
parameter can be used to supply either an experiment-level factor or a variate that is to be incorporated into the linear mixed model to account for experiment-specific effects on the estimated treatment means. You can specify these in a variate with the same length as the number of experiments. Alternatively, you can supply them in a variate with the same length as MEANS
. However, this must contain the same value for the treatments in each experiment.
The PRINT
and PSE
options controls the output from the REML
analyses, with the same settings as the PRINT
and PSE
options of REML
, respectively. The default setting of PRINT
gives a description of the model and covariance models that have been fitted, plus estimates of the variance components and the predicted means. The default setting of PSE=allestimates
gives the all the standard errors.
The MAXCYCLE
option sets a limit on the number of iterations in the REML
analysis (default 30). The SAVE
parameter can be used to name the REML
save structure for later use with the VKEEP
and VDISPLAY
directives.
Options: PRINT
, PSE
, EMETHOD
, VCMODEL
, INITIAL
, MAXCYCLE
.
Parameters: MEANS
, TREATMENTS
, EXPERIMENTS
, SEDMEANS
, VARIANCES
, MODERATOR
, SAVE
.
Method
VMETA
uses the methods described in Madden et al. (2016). The multi-treatment meta analysis (also known as network meta analysis) is performed on summary results for each treatment (i.e. means and standard error of the difference or sampling variance) using a linear mixed model, fitted by VMETA
using the REML
, VCOMPONENTS
and VSTRUCTURE
directives in the usual way.
The treatment term, and if supplied, the moderator term are fitted as fixed, but the experiment term may be fitted as either fixed or random.
The variance-covariance models that can be specified by the VCMODEL
option, and subsequently fitted by REML
using the VSTRUCTURE
directive, are:
Setting |
Description |
Variance-covariance matrix |
Number of parameters |
Fixed experiment effects |
|||
|
Identity |
Ci,i = σμ2 |
1 |
|
Diagonal matrix (heteroscedastic) |
Ci,i = σμ(i)2 |
m |
Random experiment effects |
|||
|
Compound symmetry |
Ci,i = σβ2 + σμ2 |
2 |
|
Heterogeneous compound symmetry |
Ci,i = σT(i)2 |
m + 1 |
|
Unstructured |
Ci,i = σT(i)2 |
m(m + 1)/2 |
|
First order factor analytic model with common variance |
Ci,i = γi2 + σν2 |
m + 1 |
|
Second order factor analytic model with common variance |
Ci,i = γi(1)2 + γi(2)2 + σν2 |
2m |
|
First order factor analytic model |
Ci,i = γi2 + σν(i)2 |
2m |
In this table i, j = 1 … m, where m is the number of treatments.
Action with RESTRICT
VMETA
will work with restrictions. However, if more than one variate or factor is restricted, they must be restricted in the same way. In addition, parameters SEDMEANS
, VARIANCES
and MODERATOR
may only be restricted if they supply vectors of the same length as the MEANS
variate.
References
Madden, L.V., Piepho, H.-P., & Paul, P.A. (2016). Statistical models and methods for network meta-analysis. Phytopathology, 106, 792-806.
See also
Directives: REML
, VCOMPONENTS
, VSTRUCTURE
Procedures: META
, VAMETA
, VASMEANS
Commands for: REML analysis of linear mixed models.
Example
CAPTION !t('VMETA example'),\ !t('Meta-analysis of wheat yield from Madden et al. (2016).'),\ !t('~{break}The data set contains the trial ID (factor Trial), the \ treatment ID (factor Trt), the mean yield per treatment in each trial \ (variate Yield) and corresponding within-trial sampling variance (variate \ varyld), and the wheat marketing class (factor cla).'),\ !t('~{break}Reference: Madden L.V., Piepho, H.-P., & Paul, P.A. \ (2016). Statistical models and methods for network meta-analysis. \ ~i{Phytopathology} 106(8):792-806.'); STYLE=meta,plain,plain,plain SPLOAD [PRINT=*] '%data%/MetaWheat.gsh' CAPTION !t('Fixed trial effects with heterogeneous between-trial variances');\ STYLE=major VMETA [EMETHOD=fixed; VCMODEL=diagonal] MEANS=Yield; TREATMENTS=Trt;\ EXPERIMENTS=Trial; VARIANCES=varyld CAPTION !t('Random trial effects with a heterogeneous compound symmetry \ between-trial variance-covariance structure'); STYLE=major VMETA [EMETHOD=random; VCMODEL=hcs] MEANS=Yield; TREATMENTS=Trt;\ EXPERIMENTS=Trial; VARIANCES=varyld