Retrieves a regression 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 could not be retrieved successfully, otherwise zero |
SAVE = regression save structures |
Save structure that has been retrieved |
Description
RRETRIEVE
retrieves a regression save structure, stored earlier by the RSTORE
procedure in an external file. It can then be used to produce further output from the analysis. (See, for example, directives RDISPLAY
and RKEEP
, or procedures RCHECK
, RGRAPH
and RSPREADSHEET
.)
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 could not be retrieved successfully. Otherwise it contains zero.
Options: none.
Parameters: FILENAME
, EXIT
, SAVE
.
Method
RSTORE
stores the save structure in a Genstat backing-store file using the STORE
directive, and RRETRIEVE
retrieves it using the RETRIEVE
directive.
See also
Directive: FIT
.
Procedures: ARETRIEVE
, RSTORE
.
Commands for: Regression analysis.
Example
CAPTION 'RRETRIEVE 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'