next up previous contents index
Next: The ac Command Up: WRspice Commands Previous: The xeditor Command   Contents   Index

Simulation Control Commands

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
devcnt Print device counts
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 Alias for sweep command
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
sweep Perform analysis over parameter range
tf Initiate transfer function analysis
trace Set trace
tran Initiate transient analysis
where Print nonconvergence information

next up previous contents index
Next: The ac Command Up: WRspice Commands Previous: The xeditor Command   Contents   Index
Stephen R. Whiteley 2017-03-28