RESTORE Command

Restores a saved circuit state from a checkpoint file.

Command RESTORE
Abbreviation RE
Category Session Management

Function

The RESTORE command is used to restore a specified circuit state to be used as the initial state for subsequent simulation.

Usage

The TNUM keyword is used to specify the state to be restored. If the circuit state is restored from a checkpoint file, this file is assumed to have the default file name and the default extension sav. The FILE keyword may be used to explicitly specify the checkpoint file's name.

Restoring The Initial Unknown State

The command:

RESTORE TNUM=0

restores the circuit to its initial state prior to simulation (with all signal values unknown), the simulation time to 0, and the Test number to 1.

Restoring The Last Stable State

The command:

RESTORE TNUM=*

restores the circuit to its most recent stable state, and the simulation time and Test number to their values at that time.

Restoring A Checkpoint State

The command:

RESTORE FILE=<file name>

may be used to specify the checkpoint file if this is not the default file.

The command:

RESTORE TNUM=?

may be used to determine the test numbers corresponding to all saved states in the checkpoint file.

The command:

RESTORE TNUM=<tnum>

restores the state previously saved in the checkpoint file at Test <tnum>.

By default, the Test number and simulation time are also restored to their values at the time the state was saved. The command:

NO RESTORE PRANGE:

overrides this default, and forces the Test number and simulation time to remain at their current values after the saved state is restored. For example, the command sequence

NO RESTORE PRANGE:
RESTORE TNUM=500

causes the state previously saved at Test 500 to be restored, but does not affect the current Test number and simulation time.

See the Section Replaying Portions of the Simulation in History Files for more information on the RESTORE command.