The commands described in this section control the execution of WRspice simulations. By default, there is no activity on screen during a simulation. One can monitor the progress of a run in two ways. First, the iplot command can be used to plot a variable as the simulation is progressing. To plot v(1), for example, one would type, before the run is started, ``iplot v(1)''. During the run, v(1) will be plotted on screen, with the plot rescaled as necessary. One can also print variables. For example, the trace command can be used, by typing ``trace time'' before the run starts, to cause the time value to be printed at each output point during transient analysis. These two commands are examples of what are called ``debugs''. Other debugs include stop when and stop after. A debug remains in effect until deleted with the delete command, and the debugs in effect can be listed with the status command. The debugs can also be listed, deleted, or made inactive with the Trace tool from the Tools menu. The run can be paused at any time by typing Ctrl-C in the controlling text window.
It is possible to transparently execute simulations on a remote machine while in WRspice, if the remote machine has a wrspiced daemon running. It is also possible to run simulations asynchronously on the present machine. These jobs are not available for use with the iplot command, however. The jobs command can be used to monitor their status.
Many of these commands operate on the ``current circuit'' which by default is the last circuit entered into WRspice explicitly with the source command, or implicitly by typing the file name. The setcirc command can be used to change the current circuit. The Circuits button in the Tools menu also allows setting of the current circuit.
When a circuit file is read, any references to shell variables are expanded to their definitions. Shell variables are referenced as $name, where name has been set with the set command or in the .options line. This expansion occurs only when the file is sourced, or the reset command is given, so that if the variable is changed, the circuit must be sourced or reset to make the change evident in the circuit. If a variable is set in the shell and also in the .options line, the value from the shell is used.
Simulation Commands | |
ac | Perform ac analysis |
---|---|
alter | Change circuit parameter |
aspice | Initiate asynchronous run |
cache | Manipulate subcircuit/model cache |
check | Initiate range analysis |
dc | Initiate dc analysis |
delete | Delete watchpoint |
destroy | Delete plot |
devload | Load device module |
devls | List available devices |
devmod | Change device model levels |
disto | Initiate distortion analysis |
dump | Print circuit matrix |
free | Delete circuits and/or plots |
jobs | Check asynchronous jobs |
loop | Perform analysis over range |
noise | Initiate noise analysis |
op | Compute operating point |
pz | Initiate pole-zero analysis |
reset | Reset simulator |
resume | Resume run in progress |
rhost | Identify remote SPICE host |
rspice | Initiate remote SPICE run |
run | Initiate simulation |
save | List vectors to save during run |
sens | Initiate sensitivity analysis |
setcirc | Set current circuit |
show | List parameters |
state | Print circuit state |
status | Print trace status |
step | Advance simulator |
stop | Specify stop condition |
tf | Initiate transfer function analysis |
trace | Set trace |
tran | Initiate transient analysis |
where | Print nonconvergence information |