MTDATA – Phase Diagram Software from the National Physical Laboratory

 

 

 

Home 

News 

Products 


Training and Support 

FAQs 

Links 

Agents 

Other Services 

 

Services 

 

 

SAVE

Function:

The SAVE command is used during the optimisation process to save the current values of selected FIXED, LINKED, STEPPED or OPTIMISED PARAMETERs to an in-memory store, to save data sets incorporating the current values of FIXED, LINKED, STEPPED and OPTIMISED parameters to a named DATA_LOADING_FILE ready for loading into a database or to write a SET_UP macro to be used at a later date to recreate the exact state of the current optimisation in terms of the data input filename, experimental data file name and the status and value of individual parameters.

Parameters:

data_loading_file

parameter

set_up

Defaults:

parameter = all

The default SAVEd value for each parameter is the value taken from the current data input (.mpi) file.

Examples:

save data_loading_file ‘newdata.loa’ !

save parameter 35 !

save parameter all !

save set_up ‘crfeass.mac’ !

Parameter values:


DATA_LOADING_FILE

takes the value <”file name”>

SAVE DATA_LOADING_FILE is used to save data sets incorporating the current values of all FIXED, LINKED, STEPPED and OPTIMISED parameters (se MODIFY) to a named MTDATA database loading file. The DATA_LOADING_FILE keyword should be followed by a valid file name in quotes. For example:

save data "optdata.loa" !

The resulting file can be used to create a new database or update an existing database by means of the UTILITY module’s LOAD_DATA command.

PARAMETER

takes the values <number> / ALL

SAVE PARAMETER is used to save the current values of ALL or selected FIXED, LINKED, STEPPED and OPTIMISED PARAMETERs (see MODIFY) to an in-memory store. The stored values can be inspected using the LIST PARAMETER VALUE command and restored using the RESTORE command, overwriting any new values current at the time.

To save an individual parameter the PARAMETER keyword should be followed by the appropriate parameter INDEX (see MODIFY and SHOW). To save all FIXED, LINKED, STEPPED and OPTIMISED parameters the keyword ALL should be used. For example:

save parameter = 25 !
save param all !


 

SET_UP

takes the value <”file name”>

SAVE SET_UP is used to write a SET_UP macro in which the exact state of the current optimisation, in terms of the data input (.mpi) file name, EXPERIMENTAL_FILE name and the status and value of individual parameters, is stored. Running the macro from the WHICH MODULE ? prompt during a subsequent MTDATA session will regenerate all of the SAVEd settings. The commands UNDO or RESTORE, however, will not work until further OPTIMISE or SAVE PARAMETER commands, respectively, have been issued.

The SET_UP keyword should be followed by a valid file name in quotes. For example:

save set_up “mysetup.mac” !

Updated 4 August 2010