2.40  SWEEP command

2.40.1  Syntax

sweep {stepcount} partlabel=range ...

2.40.2  Purpose

Sweep a component (or group of components) over a range. Set up a loop for iteration.

2.40.3  Comments

This command begins a loop which will sweep a component or group of components.

When this command is given, the only apparent actions will be a change in the prompt from `gnucap>' to `>>>', and some disk action.

The different prompt means that commands are not executed immediately, but are stored in a temporary file.

The bare command will repeat the same command sequence as the last time sweep was run, and not prompt for anything else.

Additional components can be swept at the same time by entering a `FAult' command at the `>>>' prompt. The `fault' behaves differently here: It accepts a range, which is the sweep limits.

The `go' command will end the entry sequence, and make it all happen. After this, the values are restored. (Also, all faults are restored, as if by the `restore' command.)

All commands can be used in this mode. Of course, some of them are not really useful (quit) because they work as usual.

Only linear, ordinary parts can be swept. (No semiconductor devices, or elements using behavioral modeling.) The tolerance remains unchanged. If you attempt to sweep a nonlinear or otherwise strange part, it becomes ordinary and linear during the sweep.

2.40.4  Example

gnucap> sweep  5   R14=1,100k   R15=100k,1
>>>list
>>>ac 500 2k oct
>>>go
This sequence of commands says to simultaneously sweep R14 and R15 in 5 steps, in opposite directions, list the circuit and do an AC analysis for each step.

Assuming the circuit was:
     R14  1   0   50k
     R15  2   0   50k
The result of this sequence would be:
     R14  1   0   1
     R15  2   0   100k
an AC analysis
     R14  1   0   25.75k
     R15  2   0   75.25k
an AC analysis
     R14  1   0   50.5k
     R15  2   0   50.5k
an AC analysis
     R14  1   0   75.25k
     R15  2   0   25.75k
an AC analysis
     R14  1   0   100k
     R15  2   0   1
an AC analysis

After all this is done, the circuit is restored, so list would show:
     R14  1   0   50k
     R15  2   0   50k
You could accomplish the same thing by entering fault commands at the `>>>' prompt.
-->sweep  5
>>>fault  R14=1, 100k
>>>fault  R15=100k, 1
>>>list
>>>ac 500 2k oct
>>>go