model restore command

Syntax

model restore s <keyword ...>

Restore program-state information. The state information, resulting from a previous model save command, is in the save file s. If s does not contain a file extension, then the extension “.sav” is added. The path to the save file can be included as part of s.

Information that is part of the project state (see project) or program state (see program) is not affected by a restore.

Unless the skip keyword is used, all model state information (including any defined FISH functions/variables, histories, tables, or model components) is lost and replaced by the information contained in the file s.

The following keywords are available:

quiet

Suppresses the notices emitted to the console when a model state is restored.

skip keyword ...

Specifies that certain model state data should not be cleared. This means that the state record is also not reset, as the new model state includes information from the previous state. Any data in the save state associated with the skipped information is not restored.

fish

All global FISH data is retained - including all global symbols, functions, and operators. Extra variables associated with model objects (Zones, Balls, etc) are still removed. Note that if the model new command is given while executing a FISH function then FISH data will be skipped automatically.

table

All data stored in tables (see the table command) is retained.

python

The Python state is not cleared, including Python global variables and functions. Note that if the model new command is given while executing a Python function then Python data will be skipped automatically.