maeLoadSetupState
maeLoadSetupState(
t_stateName
[ ?run t_runNames ]
[ ?tags l_tagNames ]
[ ?operation s_operationName ]
[ ?session t_sessionName ])
)
=> t_sessionName / nil
Description
Loads the given setup state into the given session.
Arguments
|
t_stateName
|
Name of the state to be loaded.
|
|
?run t_runName
|
Name of the run in the Run Plan to which the saved state is loaded.
|
|
?tags l_tagNames
|
List of tags that defines the components to be copied from the loaded state.
-
tests: Copies the testbench setups. -
vars: Copies the global variables. -
parameters: Copies the parameters and their values. -
currentMode: Copies the run mode. -
runOptions: Copies the simulation options for different run modes and the run distribute options. -
specs: Copies the parameter specifications. -
corners: Copies the corner details. -
modelGroups: Copies the model groups. -
extensions: Copies the extensions. -
relxanalysis: Copies the reliability analysis setup details. -
All: Copies all the details. This is the default.
|
|
?operation s_operationName
|
|
|
Operation to handle the existing details in the setup.
-
'merge - If the existing setup details have the same name as that of the details being loaded, they are deleted and overwritten by the setup information copied from the loaded state. -
'retain - If an existing setup detail has the same name as that of the detail being loaded, it is retained and not overwritten by the setup information copied from the loaded state. -
'overwrite - All existing setup details are deleted and all the imported outputs are used
|
|
?session t_sessionName
|
|
|
|
Name of the session to which the state has to be loaded.
If not specified, the current session is used.
|
Value Returned
|
t
|
Successfully loaded the given setup state.
|
|
nil
|
The setup state is not loaded.
|
Examples
Loads the corners from state state1 and merges those with the current corner details:
maeLoadSetupState("state1" ?tags list("corners") ?operation 'merge)
=> t
Loads variables and parameters from the given state and runs a simulation:
; state name to load
statestate = "GlobalOpt.2.PointID.590"
; (optional) backup current vars and params to a setup
(maeSaveSetupState state_backup ?tags '("vars" "parameters"))
(maeLoadSetupState state ?operation 'merge)
(maeRunSimulation ?runMode "Single Run, Sweeps and Corners")
Loads the corners from state state1 and merges those with the current corner details in run Run.1:
maeLoadSetupState("state1" ?tags list("corners") ?run "Run.1" ?operation 'merge)
=> t
Return to top
