MorphNet¶

A bidirectional netlist parser built on Lark, enabling translation between SPICE-family circuit netlist formats (HSPICE, Xyce, Spectre, Spectre-SPICE) and Verilog-AMS.

All formats share a common intermediate representation defined in Protocol Buffers and wrapped with Pydantic v2 models, making it straightforward to parse, transform, and serialize netlists programmatically.

Key Features¶

6 netlist formats — HSPICE, SPICE, Xyce, Spectre, Spectre-SPICE, Verilog-AMS
Bidirectional — every format has both a parser and a writer
Common IR — all formats parse into the same Circuit model
Protocol Buffers — compact binary serialization for cross-language interop
Pydantic v2 — type-safe, immutable data models with JSON and YAML support
Lark grammars — each format is defined by a clean EBNF grammar

Architecture¶

Text Only

spectre.scs ──┐                          ┌── spectre.scs
hspice.sp  ───┤  parse_*()   write_*()   ├── hspice.sp
xyce.cir   ───┼──────────► Circuit ──────►├── xyce.cir
spice.sp   ───┤          (protobuf +      ├── spice.sp
vams.vams  ───┘           pydantic)       └── vams.vams
                             │
                        to_yaml / from_yaml
                             │
                          circuit.yaml

Each format follows the same internal pipeline:

Text Only

raw text → preprocess → Lark grammar → parse tree → Transformer → Circuit
Circuit → Writer → formatted text

Quick Example¶

Python

from morphnet.netlist.spectre.parser import parse_spectre
from morphnet.netlist.vams.writer import write_vams

spectre_netlist = """\
subckt rc_lowpass (in_ out gnd)
R1 (in_ out) resistor value=1k
C1 (out gnd) capacitor value=100p
ends rc_lowpass
"""

circuit = parse_spectre(spectre_netlist)
print(write_vams(circuit))

Output:

Verilog

module rc_lowpass (in_, out, gnd);
  inout in_, out, gnd;
  resistor #(.value(1k)) R1 (.p(in_), .n(out));
  capacitor #(.value(100p)) C1 (.p(out), .n(gnd));
endmodule

Supported Formats¶

Format	Parser	Writer
HSPICE	`morphnet.netlist.hspice.parser.parse_hspice`	`morphnet.netlist.hspice.writer.write_hspice`
SPICE	`morphnet.netlist.spice.parser.parse_spice`	`morphnet.netlist.spice.writer.write_spice`
Xyce	`morphnet.netlist.xyce.parser.parse_xyce`	`morphnet.netlist.xyce.writer.write_xyce`
Spectre	`morphnet.netlist.spectre.parser.parse_spectre`	`morphnet.netlist.spectre.writer.write_spectre`
Spectre-SPICE	`morphnet.netlist.spectre_spice.parser.parse_spectre_spice`	`morphnet.netlist.spectre_spice.writer.write_spectre_spice`
Verilog-AMS	`morphnet.netlist.vams.parser.parse_vams`	`morphnet.netlist.vams.writer.write_vams`

Installation¶

Bash

pip install morphnet

Or with uv:

Bash

uv add morphnet

See Getting Started for development setup instructions.

License¶

MorphNet is licensed under the Apache License 2.0.

Home