Skip to main content
Built-in Elements

<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.

Schematic Circuit Preview
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

PropertyDescriptionExample
nameOptional label for the probe trace in graphs."VP_OUT"
connectsToPort selector that identifies the measurement node.".R1 > .pin1"
referenceToOptional port selector for differential measurements.".R1 > .pin2"
colorColor used for the voltage trace in simulation graphs."#315cff"
graphDisplayNameOptional label for oscilloscope-style graph display."VOUT"
graphCenterVoltage value shown at the center of the trace display.3.3
graphOffsetDivsVertical offset, in divisions, applied to the trace center.2
graphUnitsPerDivVoltage scale per division. For voltage probes this is volts per division.0.1

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 when several probes need different vertical scales. This is useful when a small ripple signal and a larger supply rail share the same simulation graph.

<voltageprobe
name="VOUT"
color="#0a8f3c"
connectsTo=".R_LOAD > .pin2"
referenceTo=".V1 > .pin2"
graphDisplayName="VOUT"
graphCenter={3.3}
graphOffsetDivs={-1}
graphUnitsPerDiv={0.05}
/>