Simulation

Simulation Workbench

4 min read Updated Markdown
On this page

Use the Simulation Workbench to check how a circuit behaves before you move on to PCB layout. You can view voltage waveforms, measure signals, and verify that important outputs stay within your chosen limits.

A simulation is a file of its own (.simxml). It holds one circuit, drawn in the schematic editor from parts that have a SPICE model, and it is listed in the project under its own name. The sheets of your design are not simulated: nothing you add to a simulation — supplies, probes, test loads — ever reaches the sheets, the PCB, the BOM or the ERC.

Simulator included

WireFrame ships ngspice, which runs inside the application — nothing else to install. Xyce, LTspice, and a separately installed ngspice are optional; see Engines & SPICE Models.

Get a simulation#

There are two ways to start one:

  • Copy a block of a sheet. With a sheet in front, select Simulation → Simulate a Block of This Sheet.... The dialog lists the blocks of the sheet; each shows Ready or Needs input with the reason (for example, no source drives it). Select one and click Copy to New Simulation. Its parts, the wires between them, and the labels and ports on those wires are copied into a new simulation, which opens in its own tab. Parts without a SPICE model on those wires, such as connectors, are named rather than copied.
  • Start an empty one. Select File → New → New Simulation (.simxml) or Simulation → New Simulation (.simxml) and draw the circuit. While a simulation is in front, the Library panel lists only parts that have a SPICE model.

The copy is made once. After that the sheet and the simulation do not know each other: change the sheet, and copy the block again when you want to simulate the new version.

Pressing F5 with a sheet in front opens the workbench on a page offering both buttons. With a simulation in front, F5 opens the workbench and runs the current setup.

The NE555 blinker's sheet: Simulation → Simulate a Block of This Sheet, then Copy to New Simulation — the block opens as a simulation of its own

Quick start#

  1. Copy a block into a simulation, or open one.
  2. Open Setup → Sources, add a supply on the circuit's rail, and set its value.
  3. Choose the type of analysis you need and its values.
  4. Click Preflight and resolve any item marked as blocking.
  5. Click Run (or press F5).
  6. Open Signals and enable the nets you want to view.

Workbench tabs#

Tab What you do there
Setup Check readiness, choose a simulator, add sources, and adjust the graph display
Blocks Choose which circuits of the simulation to run, when it holds more than one
Testbench Add loads and define the results that count as acceptable
Signals Show, hide, and measure voltage waveforms
Models Find components that need a simulation model
AI Ask Copilot to explain a signal or failed check

Choose an analysis#

Analysis Choose it when you want to check
Transient Startup, switching, timing, oscillation, or ripple over time
AC Sweep Gain and phase across a frequency range
DC Bias Op Steady DC voltage at each node (operating point)
DC Sweep How an output changes while an input voltage is varied

The controls below the toolbar change with the selected analysis. Hover a disabled option to see why it is unavailable for the current circuit.

Add power and input signals#

A block copied from a sheet usually has no supply of its own: on the sheet, its rail came from another part of the design. Open Setup, choose a named net, and click Add under Sources. Select the source type that matches your circuit:

  • DC for a fixed supply or input;
  • AC for small-signal frequency analysis;
  • Sine for a repeating analog input;
  • Pulse for clocks and switching inputs;
  • PWL for a custom sequence of time and voltage points.

Tip

Give important nets clear names such as VIN, VOUT, SDA, or CLK. Named nets are easier to select and understand in the results.

Run Preflight#

Preflight checks whether the simulation is ready to run. Common issues include:

  • the circuit has no GND reference;
  • components are not connected;
  • a resistor, capacitor, or source has no usable value;
  • a component needs a simulation model;
  • the selected simulator is unavailable.

Double-check the indicated component, correct the issue, then run Preflight again.

If an unrelated circuit in the simulation is not ready, open Blocks and select only the circuit you want to test.

Read the waveform#

In Signals, enable the nets you want to plot. To mark a net on the simulation's canvas instead, choose Probe Signal on its toolbar (V) and click a wire, pin, net label, or power symbol. Use the graph controls to:

  • zoom and pan;
  • fit all active signals automatically;
  • show or hide the grid and legend;
  • enable A/B cursors for interval measurements;
  • show the latest simulated voltages on the simulation's canvas (Voltage heatmap).

Use More → Export waveform CSV to save the plotted data. If a run fails, use More → Export simulation log when reporting the problem.

Continue learning#