pyspicey

A command-line reference and code generator for SPICE netlist syntax. Look up a device or statement, see exactly what parameters it takes, and generate a correct line of SPICE code without having to remember argument order.

Install

pip install pyspicey

Usage

List every available command, grouped by category:

$ pyspicey --list
Available SPICE commands (run `pyspicey <name> --help` for details):

Analysis Statements:
  ac     Small-signal AC sweep analysis (.AC)
  dc     DC sweep analysis (.DC)
  op     DC operating point analysis (.OP)
  tran   Transient analysis (.TRAN)

Controlled Sources:
  e      Voltage-controlled voltage source (VCVS)
  f      Current-controlled current source (CCCS)
  g      Voltage-controlled current source (VCCS)
  h      Current-controlled voltage source (CCVS)

Independent Sources:
  i      Independent DC/AC current source
  v      Independent DC/AC voltage source

Passive Elements:
  c      Capacitor
  l      Inductor
  r      Resistor

Semiconductor Devices:
  d      Diode
  m      MOSFET
  q      Bipolar junction transistor (BJT)

Source Functions:
  exp    Exponential waveform source function
  pulse  Pulse waveform source function
  pwl    Piecewise linear waveform source function
  sffm   Single-frequency FM waveform source function
  sin    Sinusoidal waveform source function

Subcircuits:
  x      Subcircuit instantiation

See the full parameter reference for a command:

$ pyspicey pwl --help
usage: pyspicey pwl [-h] [--current] [--r REPEAT] [--td TD]
                     name n_plus n_minus points [points ...]

Generates a waveform that linearly interpolates between explicit (time,
value) points, holding at the final value after the last point. Embed this
in a V or I source line.

positional arguments:
  name        Element name (V prefix added automatically, unless --current
              is given)
  n_plus      Positive node
  n_minus     Negative node
  points      Time/value pairs: t1 v1 t2 v2 ...

options:
  -h, --help  show this help message and exit
  --current   Emit an I (current) source instead of a V (voltage) source
  --r REPEAT  Repeat (loop) time
  --td TD     Time delay before the waveform starts

examples:
  pyspicey pwl VS in 0 0 0 1m 5 2m 0 3m 0

Generate the actual line of SPICE code:

$ pyspicey pwl VS in 0 0 0 1m 5 2m 0
VS in 0 PWL(0 0 1m 5 2m 0)

$ pyspicey r 1 in out 10k
R1 in out 10k

$ pyspicey tran 1u 10m --uic
.TRAN 1u 10m UIC

Append generated lines straight into a netlist file with -o/--output instead of printing them:

$ pyspicey -o circuit.spice r 1 in out 10k
$ pyspicey -o circuit.spice c 1 out 0 1u --ic 0
$ cat circuit.spice
R1 in out 10k
C1 out 0 1u IC=0

What's covered

• Passive elements: r, c, l
• Independent sources: v, i
• Source functions (embedded in a V/I line): pulse, sin, pwl, exp, sffm
• Semiconductor devices: d (diode), q (BJT), m (MOSFET)
• Controlled sources: e (VCVS), g (VCCS), f (CCCS), h (CCVS)
• Subcircuits: x
• Analysis statements: dc, ac, tran, op

Syntax follows the common Berkeley SPICE3 / ngspice conventions. Some simulators (LTspice, HSPICE, PSpice) may diverge slightly — check your simulator's docs for anything unusual.

License

Apache License 2.0 — see LICENSE.