Retrieves an ANOVA
save structure from an external file (R.W. Payne).
No options
Parameters
FILENAME = texts |
Name of the file storing the save structure |
---|---|
EXIT = scalars |
Scalar that contains the value one if the save structure was retrieved successfully, otherwise contains either zero or a missing value |
SAVE = asave structures |
Save structure that has been retrieved |
Description
ARETRIEVE
retrieves an ANOVA
save structure, stored earlier by the ASTORE
procedure in an external file. It can then be used to produce further output from the analysis. (See, for example, directives ADISPLAY
and AKEEP
, or procedures ACHECK
, AGRAPH
, APLOT
, APERMTEST
and ASPREADSHEET
.)
The name (and path) of the file that stores the save structure is specified, in a text, by the FILENAME
parameter. The save structure is saved by the SAVE
parameter. The EXIT
parameter can return a scalar containing the value one if the save structure was retrieved successfully. Otherwise it contains either zero or a missing value.
Options: none.
Parameters: FILENAME
, EXIT
, SAVE
.
Method
ASTORE
stores the save structure in a Genstat backing-store file using the STORE
directive, and ARETRIEVE
retrieves it using the RETRIEVE
directive.
See also
Directive: ANOVA
.
Procedure: ASTORE
.
Commands for: Analysis of variance.
Example
CAPTION 'ASTORE example',!t('Split plot design, see the',\ 'Guide to Genstat, Part 2, Section 4.2.1.'); STYLE=meta,plain SPLOAD [PRINT=*] '%GENDIR%/Data/Oats.gsh' TREATMENTS variety*nitrogen BLOCKSTRUCTURE blocks/wplots/subplots ANOVA [PRINT=aov; FPROBABILITY=yes] yield; SAVE=oatsave ASTORE 'Oats.gbs'; SAVE=oatsave " delete oatsave and run a null analysis to remove all traces " DELETE [REDEFINE=yes] oatsave TREATMENTS BLOCKSTRUCTURE ANOVA [PRINT=aov; FPROBABILITY=yes] yield " retrieve oatsave " ARETRIEVE 'Oats.gbs'; SAVE=oatsave ADISPLAY [PRINT=aov] oatsave FDELETE 'Oats.gbs'