Quick Start

This guide walks through creating your first SpiceBook notebook. You’ll build a voltage divider, simulate it, and see the results — all in the browser.

1. Open SpiceBook

   Go to spicebook.warehack.ing and click New Notebook. You’ll get a blank notebook with a single markdown cell.

2. Add a SPICE cell

   Click the + Add Cell button and select SPICE. Paste this netlist:

   * Voltage Divider
   V1 1 0 DC 5
   R1 1 2 1k
   R2 2 0 2k
   .op
   .end

   This creates a 5V source with two resistors. The .op directive runs a DC operating point analysis — it computes the steady-state voltages at every node.

3. Run the simulation

   Click the Run button on the SPICE cell (or use the keyboard shortcut). The backend sends the netlist to ngspice and returns the results:

   • V(1) = 5.0V — the supply voltage
   • V(2) = 3.333V — the divided voltage: 5 × 2k / (1k + 2k)

4. Try a transient analysis

   Replace the netlist with a time-domain simulation:

   * RC Charging Curve
   V1 1 0 PULSE(0 5 0 1n 1n 5m 10m)
   R1 1 2 1k
   C1 2 0 1u
   .tran 1u 20m
   .end

   Run it again. This time you’ll see a waveform plot showing the capacitor voltage rising exponentially toward 5V with a time constant of RC = 1ms.

5. Generate a schematic

   Click the Schematic button on any SPICE cell. SpiceBook parses the netlist and draws a circuit diagram as an SVG — resistors render as IEEE zigzag symbols with color-coded bands matching their values.

Tip

You can also create notebooks programmatically via the compose endpoint, which accepts multiple cells and can auto-run SPICE cells in a single API call.

Next Steps

• Editor Basics — cell types, toolbar actions, keyboard shortcuts
• Engines — choosing between ngspice and LTspice
• Waveform Viewer — interactive plots, oscilloscope mode, AC bode plots