Simulation Command

From LTwiki-Wiki for LTspice
Revision as of 22:33, 17 August 2009 by Analogspiceman (talk | contribs)

At the netlist level the Simulation Command is simply a line of text that begins with any of the following Dot Commands:

.tran <Tstep> <Tstop> [Tstart [dTmax]] [modifiers]
.ac <oct, dec, lin> <Nsteps> <StartFreq> <EndFreq>
.dc <srcnam> <Vstart> <Vstop> <Vincr> [<srcnam2> <Vstart2> <Vstop2> <Vincr2>]
.noise V(<out>[,<ref>]) <src> <oct, dec, lin> <Nsteps> <StartFreq> <EndFreq>
.tf V(<node>[, <ref>]) <source> OR I(<voltage source>) <source>
.op

At the schematic level these commands may be entered directly as a SPICE Directive (ctrl-right-click on the text to edit) or may be entered via the drop down menu item: Simulate => Edit Simulation Cmd.

The Edit Simulation Command dialog box organized like a row of tabbed index cards:

Transient AC Analysis DC sweep Noise DC Transfer DC op pnt
User options for the selected tab


Transient Analysis

Perform a Nonlinear Transient Analysis.

Perform a transient analysis.  This is the most direct simulation of a circuit.  It basically computes what happens when the circuit is powered up. Test signals are often applied as independent sources.

Syntax: .tran <Tstep> <Tstop> [Tstart [dTmax]] [modifiers]
  or    .tran <Tstop> [modifiers]

The first form is the traditional .tran SPICE command.  Tstep is the plotting increment for the waveforms but is also used as an initial step-size guess.  LTspice uses waveform compression, so this parameter is of little value and can be omitted or set to zero.  Tstop is the duration of the simulation.  Transient analyses always start at time equal to zero.  However, if Tstart is specified, the waveform data between zero and Tstart is not saved.  This is a means of managing the size of waveform files by allowing startup transients to be ignored.  The final parameter dTmax, is the maximum time step to take while integrating the circuit equations.  If Tstart or dTmax is specified, Tstep must be specified.

Several modifiers can be placed on the .tran line.

  • UIC:  Use Initial Conditions.  Skip the D.C. operating solution and use user-specified initial conditions.  Normally, a dc operating point analysis is performed before starting the transient analysis.  This directive suppresses this initialization.  The initial conditions of some circuit elements can be can be specified on a per-instance basis.  Hover Hint
  • steady:  Stop the simulation when steady state has been reached.
  • nodiscard:  Don't delete the part of the transient simulation before steady state is reached.
  • startup:  Solve the initial operating point with independent voltage and current sources turned off (but using any constraints specified by a .ic directive).  Then start the transient analysis and linearly ramp on these sources during the first 20 us of the simulation.
  • step:  Compute the step response of the circuit.


AC Analysis

Perform a small signal AC Analysis linearized about the DC Operating Point.

The small signal (linear) ac portion of LTspice computes the ac complex node voltages as a function of frequency.  First, the dc operating point of the circuit is found.  Next, linearized small signal models for all of the nonlinear devices in the circuit are found for this operating point.  Finally, using independent voltage and current sources as the driving signal, the resultant linearized circuit is solved in the frequency domain over the specified range of frequencies.

This mode of analysis is useful for filters, networks, stability analyses, and noise considerations.

Syntax: .ac <oct, dec, lin> <Nsteps> <StartFreq> <EndFreq>

The frequency is swept between frequencies StartFreq and EndFreq.  The number of steps is defined with the keyword "oct", "dec", or "lin" and Nsteps according to the following table:

Keyword Nsteps
Oct steps per octave
Dec steps per decade
Lin steps between
StartFreq and EndFreq


DC Sweep

Perform a DC Source Sweep Analysis.

This performs a DC analysis while sweeping the DC value of a source.  It is useful for computing the DC transfer function of an amplifier or plotting the characteristic curves of a transistor for model verification.

Syntax: .dc <srcnam> <Vstart> <Vstop> <Vincr> [<srcnam2> <Vstart2> <Vstop2> <Vincr2>]

The <srcnam> is either an independent voltage or current source that is to be swept from <Vstart> to <Vstop> in <Vincr> step sizes.  In the following example, the default BSIM3v3.2.4 characteristic curves are plotted:

* Example .dc sweep
*
M1 2 1 0 0 nbsim
Vgs 1 0 3.5
Vds 2 0 3.5
.dc Vds 3.5 0 -0.05 Vgs 0 3.5 0.5
.model nbsim NMOS Level=8
.save I(Vds)
.end


Noise

Perform a Noise Analysis.

This is a frequency domain analysis that computes the noise due to Johnson, shot and flicker noise.  The output data is noise spectral density per unit square root bandwidth.

Syntax: .noise V(<out>[,<ref>]) <src> <oct, dec, lin> <Nsteps> <StartFreq> <EndFreq>

V(<out>[,<ref>]) is the node at which the total output noise is calculated.  It can be expressed as V(n1, n2) to represent the voltage between two nodes. <src> is the name of an independent source to which input noise is referred.  <src> is the noiseless input signal.  The parameters <oct, dec, lin>, <Nsteps>, <StartFreq>, and <EndFreq> define the frequency range of interest and resolution in the manner used in the .ac directive.

Output data trace V(onoise) is the noise spectral voltage density referenced to the node(s) specified as the output in the above syntax.  If the input signal is given as a voltage source, then data trace V(inoise) is the input-referred noise voltage density.  If the input is specified as a current source, then the data trace inoise is the noise referred to the input current source signal.  The noise contribution of each component can be plotted.  These contributions are referenced to the output.  You can reference them to the input by dividing by the data trace "gain".

The waveform viewer can integrate noise over a bandwidth by ctrl-left mouse button clicking on the corresponding data trace label.


DC Transfer Function

Find the DC Small Signal Transfer Function.

This is an analysis mode that finds the dc small signal transfer function of a node voltage or branch current due to small variations of an independent source.

Syntax: .tf V(<node>[, <ref>]) <source>
  OR    .tf I(<voltage source>) <source>

Examples:

.tf V(out) Vin
.tf V(5,3) Vin
.tf I(Vload) Vin


DC Operating Point

Find the DC Operating Point

Perform a dc operating point solution with capacitances open circuited and inductances short circuited.  Usually a dc solution is performed as part of another analysis in order to find the operating point of the circuit.  Use .op if you wish only this operating point to be found.  The results will appear in a dialog box.  After a .op simulation, when you point at a node or current the .op solution will appear on the status bar.

Syntax: .op

There is no guarantee that the operating point of a general nonlinear circuit can be found with successive linear approximations as is done in Newton-Raphson iteration.  Should direct Newton iteration fail, LTspice tries a number of other methods to find an operating point.  Below is a table of the methods used and the options settings required to disable a particular method.

Method Directive to Disable
Direct Newton Iteration .opt NoOpIter
Adaptive Gmin Stepping .opt GminSteps=0
Adaptive Source Stepping .opt SrcSteps=0
Pseudo Transient .opt pTranTau=0