# fredrief/pade architecture

> Architecture diagram of the GitHub repository fredrief/pade, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fredrief/pade
- Repository: https://github.com/fredrief/pade

## Overview

PADE is a Python framework for programmatic analog and mixed-signal IC design. A designer models hierarchical circuits and simulation statements, builds and routes a corresponding layout, checks schematic–layout connectivity, then exports layout or runs simulation through a selected backend. The graph also preserves GDS import, Magic export, and netlist readers as distinct capabilities. Relationships come from README statements and the provided source excerpts/index; unsampled implementation details are represented only where documented.

Main entry points: [`pade/layout/cell.py`](https://github.com/fredrief/pade/blob/main/pade/layout/cell.py) (Layout Cells), [`pade/core/cell.py`](https://github.com/fredrief/pade/blob/main/pade/core/cell.py) (Circuit Cells), [`pade/backends/ngspice/netlist_writer.py`](https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/netlist_writer.py) (NGspice Netlists), [`pade/backends/spectre/netlist_writer.py`](https://github.com/fredrief/pade/blob/main/pade/backends/spectre/netlist_writer.py) (Spectre Netlists)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Circuit Modeling"]
  node_cell["Circuit Cells<br/>[cell.py]"]
  node_terminal["Terminals<br/>[terminal.py]"]
  node_net["Nets<br/>[net.py]"]
  node_parameter["Parameters<br/>[parameter.py]"]
  node_statements["Analysis Statements<br/>[statement.py]"]
end

subgraph group_layout["Layout Design"]
  node_layoutcell["Layout Cells<br/>[cell.py]"]
  node_geometry["Shapes &amp; Layers<br/>[shape.py]"]
  node_refs["Refs &amp; Pins<br/>[ref.py]"]
  node_transforms["Transforms<br/>[transform.py]"]
  node_routing["Router<br/>[route.py]"]
  node_connectivity["Connectivity Check<br/>[connectivity.py]"]
end

subgraph group_sim["Simulation Backends"]
  node_backendbase["Backend Interfaces<br/>[base.py]"]
  node_ngwriter["NGspice Netlists<br/>[netlist_writer.py]"]
  node_ngsim["NGspice Simulation<br/>[simulator.py]"]
  node_ngresults["Simulation Results<br/>[results_reader.py]"]
  node_spectrewriter["Spectre Netlists<br/>[netlist_writer.py]"]
  node_spectresim["Spectre Simulation<br/>[simulator.py]"]
end

subgraph group_io["Layout I/O"]
  node_gdsreader["GDS Import<br/>[layout_reader.py]"]
  node_gdswriter["GDS Export<br/>[layout_writer.py]"]
  node_magicwriter["Magic Export<br/>[layout_writer.py]"]
end

node_designer(("Designer"))
node_ngspice{{"NGspice"}}
node_spectre{{"Spectre"}}

node_designer -->|"defines circuit"| node_cell
node_designer -->|"builds layout"| node_layoutcell
node_designer -->|"sets analyses"| node_statements
node_cell -->|"creates terminals"| node_terminal
node_cell -->|"connects terminals"| node_net
node_cell -->|"stores parameters"| node_parameter
node_layoutcell -->|"adds shapes"| node_geometry
node_layoutcell -->|"creates refs"| node_refs
node_layoutcell -->|"applies transforms"| node_transforms
node_layoutcell -->|"supports routing"| node_routing
node_layoutcell -->|"checks connectivity"| node_connectivity
node_designer -->|"verifies layout"| node_connectivity
node_cell -->|"netlists circuit"| node_ngwriter
node_statements -->|"supplies statements"| node_ngwriter
node_backendbase -->|"defines interface"| node_ngwriter
node_ngwriter -->|"prepares netlist"| node_ngsim
node_ngsim -->|"runs simulation"| node_ngspice
node_ngsim -->|"produces results"| node_ngresults
node_cell -->|"netlists circuit"| node_spectrewriter
node_statements -->|"supplies statements"| node_spectrewriter
node_backendbase -->|"defines interface"| node_spectrewriter
node_spectrewriter -->|"prepares netlist"| node_spectresim
node_spectresim -->|"runs simulation"| node_spectre
node_layoutcell -->|"exports layout"| node_gdswriter
node_gdsreader -->|"imports layout"| node_layoutcell
node_layoutcell -->|"exports layout"| node_magicwriter

click node_cell "https://github.com/fredrief/pade/blob/main/pade/core/cell.py"
click node_terminal "https://github.com/fredrief/pade/blob/main/pade/core/terminal.py"
click node_net "https://github.com/fredrief/pade/blob/main/pade/core/net.py"
click node_parameter "https://github.com/fredrief/pade/blob/main/pade/core/parameter.py"
click node_statements "https://github.com/fredrief/pade/blob/main/pade/statement.py"
click node_layoutcell "https://github.com/fredrief/pade/blob/main/pade/layout/cell.py"
click node_geometry "https://github.com/fredrief/pade/blob/main/pade/layout/shape.py"
click node_refs "https://github.com/fredrief/pade/blob/main/pade/layout/ref.py"
click node_transforms "https://github.com/fredrief/pade/blob/main/pade/layout/transform.py"
click node_routing "https://github.com/fredrief/pade/blob/main/pade/layout/route.py"
click node_connectivity "https://github.com/fredrief/pade/blob/main/pade/layout/connectivity.py"
click node_backendbase "https://github.com/fredrief/pade/blob/main/pade/backends/base.py"
click node_ngwriter "https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/netlist_writer.py"
click node_ngsim "https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/simulator.py"
click node_ngresults "https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/results_reader.py"
click node_spectrewriter "https://github.com/fredrief/pade/blob/main/pade/backends/spectre/netlist_writer.py"
click node_spectresim "https://github.com/fredrief/pade/blob/main/pade/backends/spectre/simulator.py"
click node_gdsreader "https://github.com/fredrief/pade/blob/main/pade/backends/gds/layout_reader.py"
click node_gdswriter "https://github.com/fredrief/pade/blob/main/pade/backends/gds/layout_writer.py"
click node_magicwriter "https://github.com/fredrief/pade/blob/main/pade/backends/magic/layout_writer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cell,node_terminal,node_net,node_parameter,node_statements toneBlue
class node_layoutcell,node_geometry,node_refs,node_transforms,node_routing,node_connectivity toneAmber
class node_backendbase,node_ngwriter,node_ngsim,node_ngresults,node_spectrewriter,node_spectresim toneMint
class node_gdsreader,node_gdswriter,node_magicwriter toneRose
class node_designer,node_ngspice,node_spectre toneIndigo
```

## Components

### Circuit Modeling

- [Circuit Cells](https://github.com/fredrief/pade/blob/main/pade/core/cell.py): `pade/core/cell.py`
- [Terminals](https://github.com/fredrief/pade/blob/main/pade/core/terminal.py): `pade/core/terminal.py`
- [Nets](https://github.com/fredrief/pade/blob/main/pade/core/net.py): `pade/core/net.py`
- [Parameters](https://github.com/fredrief/pade/blob/main/pade/core/parameter.py): `pade/core/parameter.py`
- [Analysis Statements](https://github.com/fredrief/pade/blob/main/pade/statement.py): `pade/statement.py`

### Layout Design

- [Layout Cells](https://github.com/fredrief/pade/blob/main/pade/layout/cell.py): `pade/layout/cell.py`
- [Shapes & Layers](https://github.com/fredrief/pade/blob/main/pade/layout/shape.py): `pade/layout/shape.py`
- [Refs & Pins](https://github.com/fredrief/pade/blob/main/pade/layout/ref.py): `pade/layout/ref.py`
- [Transforms](https://github.com/fredrief/pade/blob/main/pade/layout/transform.py): `pade/layout/transform.py`
- [Router](https://github.com/fredrief/pade/blob/main/pade/layout/route.py): `pade/layout/route.py`
- [Connectivity Check](https://github.com/fredrief/pade/blob/main/pade/layout/connectivity.py): `pade/layout/connectivity.py`

### Simulation Backends

- [Backend Interfaces](https://github.com/fredrief/pade/blob/main/pade/backends/base.py): `pade/backends/base.py`
- [NGspice Netlists](https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/netlist_writer.py): `pade/backends/ngspice/netlist_writer.py`
- [NGspice Simulation](https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/simulator.py): `pade/backends/ngspice/simulator.py`
- [Simulation Results](https://github.com/fredrief/pade/blob/main/pade/backends/ngspice/results_reader.py): `pade/backends/ngspice/results_reader.py`
- [Spectre Netlists](https://github.com/fredrief/pade/blob/main/pade/backends/spectre/netlist_writer.py): `pade/backends/spectre/netlist_writer.py`
- [Spectre Simulation](https://github.com/fredrief/pade/blob/main/pade/backends/spectre/simulator.py): `pade/backends/spectre/simulator.py`

### Layout I/O

- [GDS Import](https://github.com/fredrief/pade/blob/main/pade/backends/gds/layout_reader.py): `pade/backends/gds/layout_reader.py`
- [GDS Export](https://github.com/fredrief/pade/blob/main/pade/backends/gds/layout_writer.py): `pade/backends/gds/layout_writer.py`
- [Magic Export](https://github.com/fredrief/pade/blob/main/pade/backends/magic/layout_writer.py): `pade/backends/magic/layout_writer.py`

### Other components

- **Designer**
- **NGspice**
- **Spectre**

## Connections

- Designer → Circuit Cells: defines circuit (evidence: `README.md`)
- Designer → Layout Cells: builds layout (evidence: `README.md`)
- Designer → Analysis Statements: sets analyses (evidence: `README.md`)
- Circuit Cells → Terminals: creates terminals (evidence: `pade/core/cell.py`)
- Circuit Cells → Nets: connects terminals (evidence: `pade/core/cell.py`)
- Circuit Cells → Parameters: stores parameters (evidence: `pade/core/cell.py`)
- Layout Cells → Shapes & Layers: adds shapes (evidence: `pade/layout/cell.py`)
- Layout Cells → Refs & Pins: creates refs (evidence: `pade/layout/cell.py`)
- Layout Cells → Transforms: applies transforms (evidence: `pade/layout/cell.py`)
- Layout Cells → Router: supports routing (evidence: `README.md`)
- Layout Cells → Connectivity Check: checks connectivity (evidence: `pade/layout/cell.py`)
- Designer → Connectivity Check: verifies layout (evidence: `README.md`)
- Circuit Cells → NGspice Netlists: netlists circuit (evidence: `pade/backends/ngspice/netlist_writer.py`)
- Analysis Statements → NGspice Netlists: supplies statements (evidence: `pade/backends/ngspice/netlist_writer.py`)
- Backend Interfaces → NGspice Netlists: defines interface (evidence: `pade/backends/base.py`)
- NGspice Netlists → NGspice Simulation: prepares netlist (evidence: `pade/backends/ngspice/simulator.py`)
- NGspice Simulation → NGspice: runs simulation (evidence: `README.md`)
- NGspice Simulation → Simulation Results: produces results (evidence: `pade/backends/ngspice/simulator.py`)
- Circuit Cells → Spectre Netlists: netlists circuit (evidence: `pade/backends/spectre/netlist_writer.py`)
- Analysis Statements → Spectre Netlists: supplies statements (evidence: `pade/backends/spectre/netlist_writer.py`)
- Backend Interfaces → Spectre Netlists: defines interface (evidence: `pade/backends/base.py`)
- Spectre Netlists → Spectre Simulation: prepares netlist (evidence: `pade/backends/spectre/simulator.py`)
- Spectre Simulation → Spectre: runs simulation (evidence: `README.md`)
- Layout Cells → GDS Export: exports layout (evidence: `README.md`)
- GDS Import → Layout Cells: imports layout (evidence: `pade/backends/gds/layout_reader.py`)
- Layout Cells → Magic Export: exports layout (evidence: `README.md`)
