⚡ Tube Amp CAD — Manual

Everything the application does, how to use it, what every value means, and how the simulator gets its numbers. Hover any label in the application to see the same explanations as a hint.

1. What it is

Tube Amp CAD designs and simulates vacuum-tube amplifiers (and hybrid and solid-state ones) in the browser. You draw a schematic; a circuit simulator works out the operating point of every part and the waveforms with a signal applied; bench instruments show the result as a real oscilloscope, spectrum analyzer, Bode plotter and curve tracer would. Then the same file is laid out as a printed circuit board.

Hints everywhere. A label with a dotted underline has an explanation: rest the pointer on it for a moment. Buttons show what they do in the same way.

2. Your first amplifier in ten minutes

A common-cathode 12AX7 stage, simulated and measured. Each step names exactly what to click.

  1. Start a sheet. File ▾ → New…, choose A4 landscape, give it a title, Create. You get an ISO drawing frame with a title block.
  2. Place the tube. Type 12AX7 in the palette's search box and press Enter, then click on the sheet. The tube appears as VL1.1, with its pin numbers.
  3. Place the resistors. Type 100k, Enter, click above the anode: that is the plate resistor. Type 1.5k and place it below the cathode, and 1M from the grid to ground (the grid leak). R rotates a part while you place it.
  4. Bypass the cathode. Type 47u to get an electrolytic and place it across the cathode resistor.
  5. Power and ground. From Sources place a B+ supply (set it to 250 V in the inspector), and from Ground & connectors the Ground symbols.
  6. Signal. Place a Signal generator (1 kHz, 0.1 Vpk) and a Capacitor (100n) from it to the grid.
  7. Wire it. Click a pin, click the corners, and finish on another pin or on a wire. A wire that ends on a wire joins it with a dot. W starts a wire anywhere; Esc stops.
  8. Read it. With Live on, the circuit simulates after every edit. Every net shows its DC voltage and every wire its current. Click the tube: the inspector shows Va, Vg1k, Ia, Pa, and with the signal on the plate swing, the gain and the THD.
  9. Look at the waveform. From Instruments place an Oscilloscope; wire CH1 to the grid and CH2 to the plate. Its screen is live on the schematic. Double-click it for the full oscilloscope.
  10. Frequency response. Windows ▾ → Bode plotter shows gain and phase from 1 Hz to 1 MHz with the −3 dB points.
  11. Check it. Click an empty spot: the inspector shows the circuit's Checks: anything beyond its ratings appears there in red.
  12. Save it. Ctrl+S.
Shortcut: File ▾ → Examples opens finished circuits drawn from published sources: a good way to see what a complete design looks like.

3. The Circuit CAD window

Top to bottom: the toolbar; the palette (left), the sheet (centre) and the inspector (right); the panel under the sheet (when open), with two tabs: the bill of materials and the Checks; the status bar.

3.1 Toolbar

ControlWhat it does
File nameThe circuit file open now. A yellow • marks unsaved changes. "Untitled" for a new circuit or an example.
File ▾New circuit, Add sheet, Open, Save, Save as, the Examples, Save as PDF (all sheets), Export sheet (PDF/PNG), Export PNG, Export SPICE netlist.
Edit ▾Undo, Redo, then what acts on the selection: Rotate R, Mirror M, Duplicate D, Delete Del, Copy, Paste, Select all; and Renumber designations. The right mouse button on a part or wire opens the same commands there (on empty sheet: Paste, Select all, Fit, Undo, Redo).
View ▾What the schematic shows: Voltages (each net's DC voltage, and its AC as ~Vrms in cyan; wires that carry the signal glow cyan), Currents (DC current and its direction on each wire), Legend (the key to those marks in the corner of the sheet), and the panel under the sheet on its Bill of materials, Checks or Tolerance tab (6.5). A tick means on. The menu stays open while you tick, so several can be changed at once.
↶ ↷Undo / redo (Ctrl+Z, Ctrl+Y). Every edit can be undone, including opening an example.
Select | WireThe tool: select and move (V), or draw wires from anywhere (W). The highlighted one is active.
− 49% +Zoom out / in around the centre (−, +; the mouse wheel zooms at the pointer).
FitFits the sheet you are on (the selected, last clicked or most visible one); press again for all sheets (F).
Sheet listAppears with two or more sheets: jumps to one.
● LiveAn on/off switch, its lamp green when on. On: the circuit re-simulates after every edit. Off: it simulates only when you press Simulate. Turn it off for very large circuits while you draw.
▶ SimulateSimulates until the circuit has fully settled (Ctrl+Enter). While a run is going it shows its progress ("■ Stop · 48 %"); press it again to stop.
Windows ▾Opens the instruments (Oscilloscope, Spectrum analyzer, Bode plotter, Curve tracer) and the Board layout, each in its own window. Opening one that is already open brings it to the front.
?Quick help and all keyboard shortcuts (F1), with a link to this manual.

On narrow screens the toolbar drops the product name and then the file name, so it stays one row from 1000 px up. At 900 px and below the inspector becomes a drawer over the right of the sheet: it slides in when you select something and out when the selection is cleared, and the Inspector button in the toolbar shows or hides it at any time.

3.2 Palette

3.3 Inspector

The right-hand panel shows whatever is selected.

Hover any label for its explanation. Every field and readout is described in Parts reference and Readouts.

3.4 Status bar

Left: the simulation state: "Simulated in 300 ms · 2 ms window, 16 cycles to settle", a progress bar while running, warnings in amber and errors in red. Right: the pointer's coordinates, or what you are hovering (a wire's voltage, AC swing and current; a sheet connector's partners).

3.5 Resizing panels

Drag the edge of the palette, the inspector or the bill of materials to resize it; double-click the edge to reset it. The instrument windows' side panels work the same way.

4. Drawing schematics

4.1 Placing and editing parts

4.2 Wiring

4.3 Sheets, frames and connectors

4.4 Drawing standards

5. Parts reference

Every part in the palette, what it models, and every field in its inspector. (This section is built from the application's own part library and hint texts, so it always matches the version you run.)

5.1 Transistors, MOSFETs and diodes

Their inspectors show Vce, Ic, hFE and dissipation (bipolar), Vds, Id and dissipation (MOSFET), with checks against Vceo, Ptot and the zener's power.

5.2 The tube library

99 tubes: the Soviet receiving tubes from Katsnelson & Larionov, «Отечественные приёмно-усилительные лампы и их зарубежные аналоги» (1981), and Western tubes from their makers' datasheets. Each has its Koren model fitted to datasheet operating points, its ratings, its socket and pinout, its heater, and its interelectrode capacitances. Search or sort the table:

Ratings shown blank are not given by the source and are not checked. Capacitances in pF: triode Cgk / Cga / Cak; pentode Cin / Cg1a / Cout. "≈" marks typical values for the kind of tube where no datasheet value exists.

5.3 Your own tube models (SPICE import)

Import SPICE model… in a tube's inspector adds any tube from a SPICE model: Norman Koren's, Ayumi's, Duncan's, Derk Reefman's or a maker's library. Paste the .SUBCKT … .ENDS text or open the file.

6. Simulation

6.1 What is simulated

Every run computes:

  1. The DC operating point: every node voltage and every part's current at rest.
  2. The steady state with the signal: the waveforms once every capacitor and choke has settled, over a window that is a whole number of signal periods (and of mains periods in a mains-fed circuit).

The oscilloscope can also run the power-on transient: the first seconds after switch-on, with every capacitor empty.

The Bode plotter runs a separate small-signal (AC) analysis in the background.

6.2 Live and on demand

6.3 Mains-powered circuits

Draw AC mains → power transformer → rectifier → reservoir capacitor → choke or resistor → filter capacitor, exactly as built. The simulator runs the rectifier cycle by cycle, so ripple, sag under load and the rectifier's peak currents are real. Voltages and currents on the schematic are averaged over the settled window, as a meter reads them.

Faster drawing: while working on the audio stages, feed them from a B+ supply (ideal DC) with an internal resistance; add the real supply when the stages are done.

6.4 When a run fails

6.5 Tolerance runs

Real parts are not their nominal values: resistors are ±5 %, electrolytics ±20 %, and two tubes of one type can differ by 20 % or more in plate current. View ▾ → Tolerance runs opens the Tolerance tab under the sheet, which simulates the circuit once as drawn and then once per run with every part varied, and shows how far each value moves.

The table lists each tube's Ia, Va and Pa, each transistor's current and dissipation, each speaker's output and each scope channel's AC (Vrms): the circuit as drawn (Nominal), the Min, Mean and Max over the runs, the Spread (two standard deviations against the nominal) and in how many runs the part was over its rating (Pa and Va for a tube, Ic and Ptot for a transistor). Runs that do not settle are left out and counted. Press ▶ Run again to stop; an edit marks the table as the old circuit's.

Reading it: a cathode-biased stage barely moves when its tube is changed; a fixed-bias output stage moves a lot. If any run takes a tube over its Pa, a real one of that type may too.

7. Measuring on the schematic

8. Readouts and what they mean

Every value the inspector, curve tracer and instruments show, with its meaning. The same text appears as a hint when you hover the label.

9. Checks and ratings

With nothing selected, the inspector's Checks list every problem in the circuit. Each tube's inspector shows its values as a share of their ratings: amber above 85 %, red above 100 %.

9.1 Circuit checks

9.2 Tube ratings

CheckWhat is comparedWhy it matters
PaAnode dissipation averaged over the signal cycle, vs Pa maxOverheated plates release gas, the grid emits, the tube runs away. Design for ≤ 70 % for long life.
VaIdle plate voltage vs Va maxInsulation and flash-over.
Pg2Screen dissipation averaged over the cycle, vs Pg2 maxScreens are thin wires and glow red quickly; screen dissipation peaks at full drive, not at idle.
Vg2kScreen voltage vs Vg2 maxMany output tubes allow less on the screen than on the plate (6P3S, 6F3P: 250 V).
IkCathode current vs Ik maxCathode emission is finite; overdrawing strips the coating.
VhkHeater-to-cathode voltage at its worst instant, each direction against its own ratingThe heater-cathode insulation breaks down; hum and failure. The heater is taken as grounded; set Heater DC potential on the tube for an elevated heater supply.
Grid circuit RTotal grid-to-ground (or grid-to-bias) DC resistance: stopper + leak + pot, vs Rg max for cathode or fixed biasGas and grid-emission current through too large a resistance biases the grid positive: the tube runs away as it warms. Fixed bias allows less.
RectifierRectified current and peak inverse voltageCathode stripping and arcing in the rectifier.

Ratings come from Katsnelson & Larionov for the Soviet tubes and from the makers' datasheets (RCA, Philips, Mullard, Western Electric) for the others. A rating a source does not give is not checked.

10. Instruments

All instruments read an Oscilloscope part in the circuit: place one and wire its CH1 and CH2 where you want to measure and its COM to the reference (usually ground). With several scope parts, choose which one in the window's Scope part list. The scope part's inspector has Oscilloscope ↗, Spectrum ↗, Bode ↗ buttons that open the window on that part.

10.1 Oscilloscope

10.2 Spectrum analyzer

Reading distortion: a single-ended stage makes mostly H2 (asymmetric); a balanced push-pull cancels the even harmonics and leaves H3. A rising H3, H5, H7 series means symmetrical clipping.

10.3 Bode plotter

f(−3 dB, top) ≈ 1 / (2π · Rsource · (Cgk + (1 + A) · Cga))

10.4 Curve tracer

10.5 Markers and zoom (every graph)

11. Board layout

Windows ▾ → Board layout opens the PCB of the circuit. Parts and connections come from the schematic; the layout is saved inside the circuit file.

The toolbar is one row: undo and redo; the tools (Select, Route, Via, Text, Hole, Pour, Keep-out, Measure); the active copper layer and the grid; View ▾ (grid lines, dots or none, axes, the drawing sheet's format, Lock sheet, the 3D view); Fit; then Update (amber when the schematic has changed), Board ▾ (Board setup…, Design rules…), Export ▾, help and the way back to the schematic.

11.1 Footprints

Every part gets a through-hole footprint chosen from its values: resistors by power (10.16 mm at ¼ W to 50.8 mm at 20 W); film, ceramic and mica capacitors by value; radial, snap-in and axial electrolytics by size; DO-35 to DO-201 diodes; 3 and 5 mm LEDs; TO-92 to TO-264 transistors with each part's own pin order (TO-3 gets wire pads for a chassis heatsink); 9/16/24 mm pots and a 3296W trimmer; real tube sockets (B9A, B7G, Magnoval, octal, UX4) drawn from the component side, dual tubes sharing one socket; EI30–EI96 board transformers; toggle switches, screw terminals, RCA and jack sockets. Chassis parts can get wire pads or a terminal instead. Change any footprint in the inspector.

11.2 Placing and routing

11.3 Design rules and checks

Board ▾ → Design rules… sets clearances (with a separate high-voltage clearance above a threshold voltage), the edge clearance, track widths, via and drill sizes, annular ring, solder-mask opening, and the allowed warming of a track at its DC current. Net classes (Signal, Power, HV) are set automatically from the simulated DC voltage, or by hand; heater nets are Power.

Clearance by voltage. On top of the classes, two nets keep the gap IPC-2221B table 6-1 asks for the largest voltage between them. The voltage is the worst case of their simulated DC levels and their swing in the simulation; the anode end of an output transformer's primary counts at twice its DC level, which is where an inductive load takes it at full drive. Pick the table for the board: B2 bare board (0.6 mm to 150 V, 1.25 mm to 300 V, 2.5 mm to 500 V, then 0.005 mm per volt), B4 under a permanent coating, A6 conformally coated, or Off. A mounting hole counts as chassis, 0 V. Routing, pours and the check all use it; the net table's To GND column shows each net's clearance to 0 V copper.

Heaters and shields. The schematic draws a valve's anode, grids and cathode; the board also wires its heater. Every indirectly heated valve gets its heater pins on heater nets, one pair per heater voltage (HTR6.3_A, HTR6.3_B), fed from a heater-supply connector XH1 that carries the sum of the heater currents, so the current check sizes the heater tracks. 12AX7-type valves run at 6.3 V (pins 4 + 5 against 9) or, if chosen, 12.6 V (4 to 5); a heater raised to a DC potential (the tube's Heater DC potential) gets its own supply at that voltage; a heater joined to its cathode (GZ34) gets a winding of its own. Directly heated valves are left alone: their filament is the cathode. Internal shield pins (6N23P pin 9) go to GND. Both can be turned off.

Mounting holes (H, or Board setup): Ø 3.2 mm for M3 by default. In the inspector, Plating makes one plated: a copper ring on both sides (Ring Ø, 6 mm by default), bare of solder mask, drilled with the plated holes. Give a plated hole a Net (GND for a chassis screw that grounds the board) and a pour of that net joins it; the check reports one its net does not reach. A hole that is not plated keeps every net's chassis clearance.

The design-rule check runs live: clearances, shorts, edge, annular rings and drills, widths, track width for its simulated DC current per IPC-2221, overlapping parts, mounting holes under parts (the screw head, washer and standoff need Ø 7 mm free round an M3 hole), keep-outs, silkscreen over pads, dangling tracks and vias, unplaced parts, pinouts to verify. Click an entry to go to it. Errors are red; warnings amber; the status bar turns green only when nothing is left to route.

Net names say what a net is: a sheet connector's name; B+ (or B+1, B+2 … from the highest voltage down) for supply rails, +12V for low-voltage ones; a valve electrode as VL1.1-A, VL2-G1, VL1.2-K; OUT for the output transformer's secondary, IN for a generator's output; otherwise the parts it joins (R8_C3). Boards saved with the older Net-(R8-2) names move to the new ones by themselves.

Star grounding (Ground scheme: Star point). A star terminal XG1 (a plated M3 or M4 hole for a solder lug) joins every ground return, and nothing else may. Each part with a ground pad belongs to a return: Supply (sources, rectifiers, reservoir and filter capacitors, bleeders), Output (power valves, the output transformer's secondary, the speaker), Input (the input jack), or the small-signal stage it serves (VL1: its cathode resistor, bypass and grid leak). A part's inspector shows its return and can move it. The ratsnest joins each return's pads and runs the return to XG1 on its own; ground copper that joins two returns anywhere else is reported, since the reservoir's charging pulses would then flow through the signal ground. A ground pour joins everything, so it is for the Free scheme.

Teardrops (on by default): where a track meets a round pad or a via, copper widens from the track to most of the pad's width over about a pad's length, so the joint survives drilling slop, soldering heat and a heavy part's leverage. They go to the Gerbers, PDFs and SVG; one is left out where it would break a clearance, and pours keep clear of them. A track as wide as its pad needs none.

Valve layout checks (warnings, each with its distance in the rules):

11.4 3D and exports

12. Files and exports

13. Keyboard shortcuts

Shortcuts go by the key's position, so they work with a Russian or any other layout.

Circuit CAD

R / Mrotate / mirror (also while placing)
D, Ctrl+Dduplicate
Deldelete
W / Vwire tool / select tool
Esccancel, clear the selection, close a menu
Ffit the sheet; again: all sheets
Bbill of materials
+ / −, wheelzoom
Space+drag, middle-dragpan
Ctrl+Z / Yundo / redo
Ctrl+C / V / Acopy / paste / select all
Ctrl+Ssave (Shift: save as)
Ctrl+Oopen
Ctrl+Entersimulate until settled
F1, ?help

Board

Sselect
Xroute
Vvia / switch the active layer while routing
Shift+Vvia tool
/diagonal first
Backspacetake back the last corner
T / H / Dtext / mounting hole / measure
P / Kcopper pour / keep-out
Uselect the connected track
Llock / unlock
R / Mrotate / other side
arrowsnudge (Shift: ×10)
`highlight the net
F / Shift+Ffit board / sheet
G / A / 3grid style / axes / 3D

14. Design cookbook

Worked procedures, with the formulas the simulator lets you check.

14.1 A triode voltage amplifier

  1. Pick Va and Ia from the curve tracer: a 12AX7 at 150–200 V and 0.8–1.2 mA; a 6N2P similar; a 12AU7 / 6N8S at 8–10 mA.
  2. Plate resistor: Ra = (B+ − Va) / Ia. 100–220 kΩ for a 12AX7.
  3. Cathode resistor: Rk = −Vg / Ia (read Vg at the operating point on the curves),; try the nearest E24 values and read Ia in the tube's inspector.
  4. Gain, bypassed: A = µ · Ra / (Ra + rp). Unbypassed: A = µ · Ra / (Ra + rp + (µ + 1) · Rk). Compare with the inspector's Plate/grid gain.
  5. Cathode bypass corner: f ≈ 1 / (2π · Ck · (Rk ‖ (Ra + rp)/(µ + 1))).
  6. Coupling capacitor corner: f = 1 / (2π · Cc · (Rout + Rnext)). Check both on the Bode plot.
  7. Top corner (Miller): see Bode plotter.

14.2 A single-ended output stage

  1. Choose the load: roughly Zp ≈ 2 · Va / Ia for a pentode, 2–3 × rp for a triode.
  2. Bias for 60–70 % of Pa max: adjust the cathode resistor (or the bias voltage) and read Pa in the tube's inspector against Pa max.
  3. Check the output transformer's DC current rating (the check does it) and its primary inductance for the bass: f−3dB ≈ (rp ‖ Zp) / (2π · Lp).
  4. Drive it to just below clipping: watch the scope for flat tops and the spectrum's THD. Read Output (speakers) in the circuit summary.
  5. Check Pg2 at full drive (pentodes): it is highest there.

14.3 A push-pull stage

14.4 A power supply

14.5 Global feedback

15. How the simulator works

E1 = (Va / kp) · ln(1 + exp(kp · (1/µ + Vg / √(kvb + Va²))))
Ia = 2 · E1^x / kg1
Is  = 2 · E1^x / kg1      with E1 = (Vg2 / kp) · ln(1 + exp(kp · (1/µ + Vg / Vg2)))
Ia  = Is · tanh(Va / vk) · (1 + Va / λ)
Ig2 = (Vg + Vg2/µ)^x / kg2 + ks · Is · (1 − tanh(Va / vk))

16. Accuracy and limits

Know the limits.
  • A model is exact only near its fit points, and production tubes vary ±20 % or more.
  • The 12AX7's µ rises to about 106 at 150–170 V (fitted at 250 V), so small-signal gains there come out 5–20 % high.
  • The knee of pentodes without published full-power data (EL34, KT88, 6P1P, GU-50, 6P45S) is a median of other fits.
  • Heaters are not simulated (the cathode is always hot); there is no warm-up.
  • Transistor models leave out base resistance and thermal effects: solid-state distortion comes out optimistic.

17. Troubleshooting and FAQ

The instruments say "Waiting for the Circuit CAD…"

They need the Circuit CAD window open in the same browser. Open them from its Windows ▾ menu.

An instrument says "no scope in circuit"

Place an Oscilloscope part (palette → Instruments) and wire its channels.

The Bode plotter shows nothing

It needs a signal generator in the circuit as well as a scope part.

A voltage sticker is missing

There was no free room for it. Zoom in, or hover the wire to read it in the status bar.

The gain is higher than my hand calculation

Check rp and µ at your operating point in the curve tracer (markers give gm, rp, µ at a point): they change with current. See the 12AX7 note in Accuracy.

My real amp draws a different current

Normal tube spread: real tubes of one type differ by ±30 % in anode current at the same bias. Adjust the cathode resistor (or the bias voltage) in the circuit until the simulation draws what you measured.

Where are my circuits kept?

The open circuit is autosaved in this browser. Save files (Ctrl+S) to keep them safely or move them between computers.

Can I run it offline?

Yes: any static web server, e.g. python3 -m http.server in the folder. The simulator needs http://, not file://.

Tube Amp CAD · · MIT licence.

↑