<voltageprobe />

Overview

<voltageprobe /> records voltage values during SPICE simulation. It attaches to an existing node in your schematic and appears in the simulation graph output. Use probes to capture input/output signals or differential measurements across components.

export default () => (
  <board routingDisabled>
    <voltagesource name="V1" voltage="5V" />
    <resistor name="R1" resistance="1k" />
    <resistor name="R2" resistance="1k" />

    <trace from=".V1 > .pin1" to="net.VCC" />
    <trace from="net.VCC" to=".R1 > .pin1" />
    <trace from=".R1 > .pin2" to=".R2 > .pin1" />
    <trace from=".R2 > .pin2" to="net.GND" />
    <trace from="net.GND" to=".V1 > .pin2" />

    <voltageprobe name="VP_R1" connectsTo=".R1 > .pin1" />
    <voltageprobe name="VP_R2" connectsTo=".R2 > .pin1" />

    <analogsimulation duration="10ms" timePerStep="0.1ms" spiceEngine="ngspice" />
  </board>
)

Properties

Property	Description	Example
name	Optional label for the probe trace in graphs.	"VP_OUT"
connectsTo	Port selector that identifies the measurement node.	".R1 > .pin1"
referenceTo	Optional port selector for differential measurements.	".R1 > .pin2"
color	Color used for the voltage trace in simulation graphs.	"#315cff"
graphDisplayName	Optional label for oscilloscope-style graph display.	"VOUT"
graphCenter	Voltage value shown at the center of the trace display.	3.3
graphVerticalOffset	Vertical offset from the graph center. Accepts numbers or SI-prefixed strings.	"1V"
graphVoltagePerDiv	Voltage scale per division. Accepts numbers or SI-prefixed strings.	"500mV"

Add probes for every signal you want plotted in the simulation graph. When you provide referenceTo, the probe measures the voltage difference between the connectsTo node and the reference node.

Scope-style graph display

Use the graph display props to override how a voltage probe channel appears when an <analogsimulation /> uses graphIndependentAxes. This is useful when a small ripple signal and a larger supply rail share the same simulation graph.

graphVerticalOffset is expressed in voltage units, not divisions. For example, graphVerticalOffset="1V" with graphVoltagePerDiv="500mV" places the trace center two divisions away from the axis center.