model new command

Syntax

model new <keyword ...>

Clear model-state information. Model information is cleared, allowing one to begin a new problem.

The optional force keyword suppresses the model reset confirmation dialog (which will normally appear if the model has changed since the last save when the model.new command is used).

Values associated with the project or program state are unaffected by the model new command unless the project keyword is given. See the project new and program commands.

Model-state information includes any defined FISH functions and variables, histories, and tables.

The entire model state can be written to a file via the model save command for subsequent recovery via the model restore command. Alternatively, a FISH function can write data to a file (see File Utilities), and a different FISH function (created after the model.new command is executed) can read back that data.

Note

When running several different problems from a called file, the model new command must be given before each new problem.

The following keywords are available:

force

If the model new command comes from an interactive source, a confirmation prompt will be presented if the model state has changed since the last save. This keyword suppresses that prompot.

project

Resets the current project state (see project new) as well as the model state.

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.

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.