2.40.1 Syntax

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.