Does the same analysis of variance for several y-variates, and collates the output (R.W. Payne & D.B. Baird).
Options
PRINT = string tokens |
Controls printed output (summary, monitoring); default * i.e. none |
|---|---|
TREATMENTSTRUCTURE = formula |
Treatment formula for the analysis; if this is not set, the default is taken from the setting (which must already have been defined) of the TREATMENTSTRUCTURE directive |
BLOCKSTRUCTURE = formula |
Block formula for the analysis; if this is not set, the default is taken from any existing setting specified by the BLOCKSTRUCTURE directive and if neither has been set the design is assumed to be unstratified (i.e. to have a single error term) |
COVARIATE = variates |
Defines any covariates |
FACTORIAL = scalar |
Limit on the number of factors in a treatment term |
SAVETERMS = formula |
Treatment terms for which to save information; if this is not set, information is saved for all the treatment terms |
REPLICATION = pointer |
Pointer to tables saving the replication of the SAVETERMS |
SPREADSHEET = string tokens |
What results to save in spreadsheets (aov, means, vcmeans, effects, vareffects, seeffects, contrasts, secontrasts, tcontrasts, prcontrasts); default * i.e. none |
CONTRASTSLIMIT = scalar |
Limit on the order of a contrast of a treatment term; default 4 |
DEVIATIONSLIMIT = scalar |
Limit on the number of factors in a treatment term for the deviations from its fitted contrasts to be retained in the model; default 9 |
Parameters
Y = variates or pointers |
Y-variates for each analysis |
|---|---|
VFACTOR = factors |
Identifies the individual y-variates when they are supplied in a single Y variate |
RESIDUALS = variates or matrices |
Saves the residuals |
FITTEDVALUES = variates or matrices |
Saves the fitted values |
MEANS = pointers |
Pointer to a matrix for each of the SAVETERMS, saving the means from each analysis |
VCMEANS = pointers |
Pointer to matrices saving variances and covariances for the means |
EFFECTS = pointers |
Pointer to matrices saving effects |
VAREFFECTS = pointers |
Pointer to variates saving unit variances for effects |
SEEFFECTS = pointers |
Pointer to matrices saving effective standard errors of effects |
TEFFECTS = pointers |
Pointer to matrices saving t-statistics for effects |
PREFFECTS = pointers |
Pointer to matrices saving probabilities of t-statistics for effects |
DF = pointers |
Pointer to variates saving degrees of freedom |
SS = pointers |
Pointer to variates saving sums of squares |
MS = pointers |
Pointer to variates saving mean squares |
RDF = pointers |
Pointer to variates saving degrees of freedom for the residual corresponding to each of the SAVETERMS |
RSS = pointers |
Pointer to variates saving residual sums of squares |
RMS = pointers |
Pointer to variates saving residual mean squares |
VR = pointers |
Pointer to variates saving variance ratios |
PRVR = pointers |
Pointer to variates saving probabilities for the variance ratios |
CONTRASTS = pointers |
Pointer to matrices saving estimates of contrasts |
SECONTRASTS = pointers |
Pointer to matrices saving standard errors of contrasts |
TCONTRASTS = pointers |
Pointer to matrices saving t statistics for contrasts |
PRCONTRASTS = pointers |
Pointer to matrices saving probabilities for t statistics of contrasts |
OUTFILENAME = texts |
Name of Genstat workbook file (.gwb) or Excel (.xls or .xlsx) file to create
|
Description
The AYPARALLEL procedure does a “parallel” analysis of variance for several y-variates, combining and summarizing the information from all the analyses. The procedure operates most efficiently if the y-values for the analyses are in separate variates (with their units in identical orders). The variates should be placed into a pointer, which should then be used as the setting of the Y parameter of AYPARALLEL. The alternative format has the values for all the analyses in a single variate (which should again be used as the setting of the Y parameter). You must then also set the VFACTOR parameter, to a factor to indicate which values are involved in each analysis.
The BLOCKSTRUCTURE and TREATMENTSTRUCTURE options can specify block and treatment formulae (as in ordinary ANOVA) to define the models for the analysis of variance. If the TREATMENTSTRUCTURE option is not set, AYPARALLEL will use the model already defined by the TREATMENTSTRUCTURE directive, or will fail if that too has not been set. Similarly, if the BLOCKSTRUCTURE option is not set, AYPARALLEL will use the model (if any) previously defined by the BLOCKSTRUCTURE directive. The lengths of the block and treatment factors should be the same as the Y variate or variates. Furthermore, if there is a single Y variate, there must be a unique combimation of the levels of the block factors for every unit (this is required so that AYPARALLEL can check that the y-values are in the correct order for each analysis). The FACTORIAL option sets a limit on the number of factors in a treatment term, as in the ANOVA directive. Similarly the CONTRASTSLIMIT and DEVIATIONSLIMIT options operate as the CONTRASTS and DEVIATIONS options of ANOVA.
The COVARIATE option can list any covariates for the analyses; if this is unset, the default is taken from any existing setting defined by the COVARIATE directive. The lengths of the covariates should be the same as the Y variate or variates.
The RESIDUALS and FITTEDVALUES parameters can save the residuals and fitted values, respectively. These will each be in a pointer with a variate for each analysis if the y-values were specified in separate variates, or in a single variate if the y-values were combined in a single variate. The REPLICATION option saves a pointer containing the replication tables for the SAVETERMS. Parameters MEANS and EFFECTS save tables of means and effects from each analysis. The information is stored in a pointer with a matrix for each of the SAVETERMS. The matrices have a row for each analysis, and the columns are labelled to show how they correspond to the cells of the table. (Note that their ordering is the same as the order in which the contents of the REPLICATION table is stored.) Similarly SEEFFECTS saves effective standard errors for the effects, and VCMEANS saves the variances and covariances of the means. VAREFFECTS saves a pointer of variates storing the unit variances of the effects, obtained by the VARIANCE parameter of AKEEP. Parameters DF, SS, MS, RDF, RSS, RMS, VR and PRVR store information from the analysis of variance table, in pointers with a variate for each term and a unit for each analysis. DF store the number of degrees of freedom for the relevant term (and analysis), SS stores sums of squares, MS stores mean squares, VR stores variance ratios, and PRVR the corresponding probabilities. Similarly the RDF parameter stores the number of degrees of freedom for the appropriate residual for the term, RSS stores the residual sums of squares, and RMS the residual mean square.
Printed output is controlled by the PRINT option, with settings:
monitoring |
to print a running total of the number of analyses that have been analysed, and |
|---|---|
summary |
to print a summary of the significance levels found for the analyses for each of the SAVETERMS. |
The SPREADSHEET option lets you save various output components in spreadsheets. You can save these in either a Genstat workbook (.gwb) or an Excel spreadsheet (.xls or .xlsx), by setting the OUTFILENAME option to the name of the file to create. If the name is specified without a suffix, ‘.gwb’ is added (so that a Genstat workbook is saved). If OUTFILENAME is not specified, they are put into a spreadsheet opened inside Genstat.
Options: PRINT, TREATMENTSTRUCTURE, BLOCKSTRUCTURE, COVARIATE, FACTORIAL, SAVETERMS, REPLICATION, SPREADSHEET, CONTRASTSLIMIT, DEVIATIONSLIMIT.
Parameters: Y, VFACTOR, RESIDUALS, FITTEDVALUES, MEANS, VCMEANS, EFFECTS, VAREFFECTS, SEEFFECTS, DF, SS, MS, RDF, RSS, RMS, VR, PRVR, CONTRASTS, SECONTRASTS, TCONTRASTS, PRCONTRASTS, OUTFILENAME.
Method
The analyses are performed by the ANOVA directive.
Action with RESTRICT
Any restrictions on the y-variates will be removed.
See also
Directive: ANOVA.
Procedures: MAANOVA, RYPARALLEL.
Commands for: Analysis of variance.
Example
CAPTION 'AYPARALLEL example'
VARIATE [NVALUES=9] AB011264,AB011266,AB019525
READ AB011264
4.2 5.1 11.6 3 3.9 9.3 3.3 4.4 10 :
READ AB011266
12.5 3 8.8 8.7 2.3 7.1 10.3 2.5 6.9 :
READ AB019525
1.5 6.2 8.9 1.3 4.5 7.7 1.3 5.1 7 :
FACTOR [LEVELS=3; VALUES=(1...3)3] Reps
FACTOR [LEVELS=!(0,1,2); ; VALUES=3(0...2)] Times
TREATMENTSTRUCTURE POL(Times;1)
BLOCKSTRUCTURE Reps
AYPARALLEL [PRINT=monitoring,summary] !p(AB011264,AB011266,AB019525);\
RESIDUALS=residuals; FITTEDVALUES=fittedvals;\
DF=df; SS=ss; MS=ms; RSS=rss; RDF=rdf; RMS=rms; VR=vr; PRVR=prvr;\
EFFECTS=effects; SEEFFECTS=seeffects; TEFFECTS=teffects;\
PREFFECTS=preffects; CONTRASTS=contrasts; SECONTRASTS=secontrasts;\
TCONTRASTS=tcontrasts;\
PRCONTRASTS=prcontrasts
PRINT #df,#ss,#ms,#rdf,#rss,#rms,#vr,#prvr
& [SERIAL=yes] residuals,fittedvals,\
effects[],seeffects[],teffects[],preffects[],\
contrasts[],secontrasts[],tcontrasts[],prcontrasts[]