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'