Stores a regression save structure in an external file (R.W. Payne).
No options
Parameters
FILENAME = texts |
Name of the file to store the save structure |
|---|---|
EXIT = scalars |
Scalar that contains the value one if the save structure could not be stored successfully, otherwise zero |
SAVE = regression save structures |
Save structure to be stored; default stores the save structure from the most recent regression analysis |
Description
RSTORE stores a regression save structure in an external file. It can then be loaded back into Genstat in a later run, by the RRETRIEVE procedure, so that further output can be produced from the analysis. (See, for example, directives RDISPLAY and RKEEP, or procedures RCHECK, RGRAPH and RSPREADSHEET.)
The name (and path) of the file to store the save structure is specified, in a text, by the FILENAME parameter. The save structure is specified by the SAVE parameter. If this is unset, ASTORE stores the save structure from the most recent regression. The EXIT parameter can return a scalar containing the value one if the save structure could not be stored successfully. Otherwise it contains zero.
Options: none.
Parameters: FILENAME, EXIT, SAVE.
Method
The save structure is stored in a Genstat backing-store file by the STORE directive.
See also
Directive: FIT.
Procedures: ASTORE, RRETRIEVE.
Commands for: Regression analysis.
Example
CAPTION 'RSTORE example',\
!t('Model atmospheric pressure on boiling point',\
'(data from Atkinson, 1985, Plots, Transformations & Regression).');\
STYLE=meta,plain
VARIATE [NVALUES=17] Boil,Pressure
READ Boil,Pressure
194.5 20.79 194.3 20.79 197.9 22.40 198.4 22.67 199.4 23.15
199.9 23.35 200.9 23.89 201.1 23.99 201.4 24.02 201.3 24.01
203.6 25.14 204.6 26.57 209.5 28.49 208.6 27.76 210.7 29.04
211.9 29.88 212.2 30.06 :
CALCULATE LogPressure = 100*LOG10(Pressure)
MODEL [SAVE=boilsave] LogPressure
FIT Boil
" save boilsave "
RSTORE 'Boil.gbs'; SAVE=boilsave
" delete boilsave and run a null analysis to remove all traces "
DELETE [REDEFINE=yes] boilsave
MODEL LogPressure
FIT
" retrieve boilsave and print the estimates again "
RRETRIEVE 'Boil.gbs'; SAVE=oatsave
RDISPLAY [PRINT=estimates; SAVE=oatsave]
FDELETE 'Boil.gbs'