schemd

Author diagrams

Use every 0.8 primitive deliberately

Exhaustive families, variants, options, semantic ports, and canonical orientations.

sheet
6 / 16
rev
v0.8
sections
5
compiled
6

Every direction-sensitive family defaults to orientation=right; a rotationally symmetric node such as junction rejects the option outright. Aliases are still accepted, but the names in these tables are the ones 0.5 emits — an alias is rewritten to its canonical terminal before anything downstream sees it, so these are the names a host must key on.

01 / ElectricalSources, connectivity, switching, and instruments

Kind type variants Stable ports
source voltage-dc, voltage-ac, voltage-pulse, current-dc, current-ac, battery, vcvs, vccs, ccvs, cccs negative, positive; dependent sources add control-positive, control-negative
junction, testpoint — node
connector — in, out
power vcc, vdd, vss, positive, negative in
switch spst, spdt, pushbutton, relay in, out; SPDT: common, normally-open, normally-closed; relay: coil1, coil2
protection fuse, breaker in, out
amplifier opamp, comparator, instrumentation positive, negative, out, v+, v-
resonator crystal, ceramic in, out
meter voltmeter, ammeter in, out
load lamp, motor, speaker, buzzer in, out 
connector:J8 "supply inlet" at (90, 150) #slate
protection:F8 "fuse" at (270, 150) #amber [type=fuse]
switch:K8 "contactor" at (460, 150) #cyan [type=relay]
meter:V8 "V" at (660, 150) #purple [type=voltmeter]
load:P8 "pump" at (860, 150) #emerald [type=motor]
testpoint:TP8 "TP8" at (460, 310) #cyan

J8.out -> F8.in #slate [line]
F8.out -> K8.in #amber [line]
K8.out -> V8.in #cyan [line]
V8.out -> P8.in #emerald [line marker-end=arrow]
K8.out -> TP8.node #cyan [ortho]
compiled by @schemd/core → shown in the rail

A relay is two circuits in one symbol: in/out carry the load, coil1/coil2 carry the control that closes it. That separation is why the contactor above needs no second component to be honest about what switches it.

02 / ElectricalPassives and semiconductor variants

Passives share in/out; diodes expose anode/cathode. Transistor controls are base for BJT, gate for FET/IGBT, plus collector/emitter or drain/source.

Kind Variants
resistor fixed, variable, rheostat, potentiometer, thermistor, ldr
capacitor fixed, variable, polarized
inductor fixed, coupled, transformer
diode standard, schottky, zener, led, photodiode, varactor, scr, triac
transistor npn, pnp, nmos, pmos, njfet, pjfet, nigbt, pigbt
port optional width=1..256; in, out
ground signal, earth, chassis; in 
resistor:RP8 "potentiometer" at (100, 150) #amber [type=potentiometer]
capacitor:CV8 "variable" at (290, 150) #cyan [type=variable orientation=down]
inductor:TX8 "transformer" at (480, 150) #purple [type=transformer]
diode:DS8 "Schottky" at (670, 150) #blue [type=schottky]
transistor:QP8 "p-MOS" at (860, 150) #emerald [type=pmos orientation=up]
compiled by @schemd/core → shown in the rail

Note that the variant changes the symbol, never the port contract. A potentiometer and a fixed resistor are both wired in to out, so swapping one for the other is a one-word edit rather than a rewiring.

03 / DigitalLogic, sequential blocks, and explicit buses

Classical gates are and, or, not, nand, nor, xor, and xnor; they use indexed in1..inN, out1..outN and accept standard=ieee|iec.

Kind type variants Stable special ports
buffer plain, tristate, tristate-inverter, schmitt, schmitt-inverter in1, out1; tri-state adds enable
logic high, low, unknown, high-z out
clock — out
flipflop sr-latch, d-latch, d, jk, t clock, enable, preset, clear, q, nq, plus type inputs
mux mux, demux indexed data ports, select, enable
encoder, decoder — indexed inputs/outputs
register — in, out, clock, enable, clear; width=2..256
counter — indexed output, clock, enable, clear
adder half, full indexed inputs/outputs
comparator — in1, in2, gt, eq, lt
bus tap, splitter, joiner bus, tap, or indexed branches; width=2..256 
port:TEMP "temp" at (80, 130) #blue
port:LIMIT "limit" at (80, 250) #amber
comparator:CP8 "temp ? limit" at (400, 190) #cyan
junction:HOT "hot" at (650, 190) #cyan
mux:ROUTE "route" at (860, 190) #purple [type=mux]
register:LATCH8 "latch" at (650, 420) #emerald [width=1]
clock:TICK8 "TICK" at (200, 420) #amber
port:FAN "fan" at (1050, 190) #emerald

TEMP.out -> CP8.in1 #blue [digital line]
LIMIT.out -> CP8.in2 #amber [digital line]
CP8.gt -> HOT.node #cyan [digital line]
HOT.node -> ROUTE.select #cyan [digital ortho]
HOT.node -> LATCH8.in1 #cyan [digital line]
TICK8.out -> LATCH8.clock #amber [digital ortho]
ROUTE.out1 -> FAN.in #emerald [digital line marker-end=arrow]
compiled by @schemd/core → shown in the rail

A comparator publishes three answers — gt, eq, lt — rather than one boolean, so a datapath that cares about which way a threshold was crossed does not need a second gate to find out.

04 / QuantumNamed gates, two-track CNOT, multi-track operators, and classical results

Single-qubit shells are hadamard, qgate, xgate, ygate, zgate, sgate, sdg, tgate, tdg, sx, phase, rx, ry, rz, and ugate; they use in/out. qgate accepts parameter, phase, and matrix detail rows.

Kind Stable ports and options
cnot control rail in1, out1; target rail in2, out2; legacy aliases in, out, control, target remain accepted
measure in, out, classical
reset in, out
prepare out
control in, out, control; control=positive, negative, or classical
swap, cz, cphase, toffoli, controlled, barrier, delay indexed inN, outN, controlN, targetN; bounded wires, controls, targets
classical-bit in, out
classical-register in, out, width=2..256

cnot always owns exactly two continuous qubit rails. Use the indexed through-ports when composing a circuit; control and target address the marker locations for compatibility and interaction metadata. initial and final belong to UML state/activity diagrams—they are not quantum state boundaries. Start a quantum rail with prepare, and terminate it with measure or a system port when it remains unmeasured.

prepare:A0 "|1\rangle" at (80, 110) #blue
prepare:A1 "|1\rangle" at (80, 250) #blue
prepare:A2 "|0\rangle" at (80, 390) #blue
toffoli:TOF "CCX" at (420, 250) #purple [controls=2 targets=1]
measure:MZ8 "M_z" at (700, 390) #cyan
classical-bit:CB8 "c_1" at (880, 390) #emerald

A0.out -> TOF.in1 #blue [quantum line]
A1.out -> TOF.in2 #blue [quantum line]
A2.out -> TOF.in3 #blue [quantum line]
TOF.out3 -> MZ8.in #purple [quantum line]
MZ8.classical -> CB8.in #cyan [classical line marker-end=arrow]
compiled by @schemd/core → shown in the rail

The rails are indexed and continuous: inN enters, outN leaves, and the operator sits across all of them. measure is the only place a quantum rail becomes classical, which is why its classical port — not its out — feeds the classical bit.

cnot is the two-track case of the same rule, and the one most often written wrongly. It owns exactly two continuous rails: the control enters at in1 and leaves unchanged at out1, the target enters at in2 and leaves at out2. The legacy control and target names still resolve — they address the marker positions — but a composed circuit should use the indexed through-ports, because those are the terminals the netlist and the full-mode metadata carry.

prepare:QA "|1\rangle" at (90, 110) #blue
prepare:QB "|0\rangle" at (90, 250) #blue
cnot:CX "CNOT" at (450, 180) #purple
port:CTRL "control" at (780, 110) #emerald
port:TGT "target" at (780, 250) #emerald

QA.out -> CX.in1 #blue [quantum line]
QB.out -> CX.in2 #blue [quantum line]
CX.out1 -> CTRL.in #purple [quantum line]
CX.out2 -> TGT.in #purple [quantum line marker-end=arrow]
compiled by @schemd/core → shown in the rail

05 / UMLStructural, deployment, activity, state, and interaction nodes

The UML catalog includes:

  • Structure: class, interface, provided-interface, required-interface, enumeration, datatype, object, component, component-port, artifact, node, device, execution, system, package, note.
  • Behavior: actor, usecase, state, action, decision, merge, fork, join, activity-final, flow-final, object-node, send-signal, receive-signal, partition.
  • Interaction/state: lifeline, activation, destruction, fragment, interaction, gate, found, lost, choice, state-junction, history, entry, exit, terminate, region, initial, final.

Sized rectangular nodes accept bounded width and height. Class-like nodes additionally accept stereotype, attributes, and operations. Their ports are left, right, top, and bottom.

Relations are association, dependency, generalization, realization, aggregation, composition, message, synchronous, asynchronous, return, control-flow, object-flow, assembly, delegation, transition, include, and extend.

lifeline:CI8 "Release job" at (220, 270) #cyan [width=170 height=400]
lifeline:REG8 "Registry" at (620, 270) #amber [width=170 height=400]
artifact:SBOM8 "sbom.json" at (880, 110) #emerald [width=170 height=80]

CI8.right90 -> REG8.left90 #cyan [line synchronous label="publish(0.8.0)"]
REG8.left180 -> CI8.right180 #amber [line return dashed label="integrity"]
CI8.right270 -> REG8.left270 #cyan [line asynchronous label="sign release"]
SBOM8.bottom -> REG8.top #emerald [ortho dependency label="manifest"]
compiled by @schemd/core → shown in the rail

A lifeline exposes leftNN and rightNN, placing a port exactly NN units below its top edge — which is what lets three messages sit at three exact heights without a layout engine deciding for us.