1. Home
  2. RRETRIEVE procedure

RRETRIEVE procedure

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'
Updated on March 5, 2019

Was this article helpful?