# gdsfactory/skywater130 architecture

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

- Interactive diagram: https://gitdiagram.com/gdsfactory/skywater130
- Repository: https://github.com/gdsfactory/skywater130

## Overview

This repository packages a gdsfactory process design kit for SKY130 chip design. A designer imports the package to activate the PDK, then uses its registered fixed and parametric cells, layer definitions, cross-sections, and routing strategies to build layouts; the technology configuration also supports KLayout. The graph preserves the major cell, routing, technology, and model domains. Some subsystem relationships are documented only by the source index, so unsampled implementation links are omitted rather than inferred.

Main entry points: [`sky130/layers.py`](https://github.com/gdsfactory/skywater130/blob/main/sky130/layers.py) (Process Layers), [`sky130/__init__.py`](https://github.com/gdsfactory/skywater130/blob/main/sky130/__init__.py) (PDK Activation), [`sky130/config.py`](https://github.com/gdsfactory/skywater130/blob/main/sky130/config.py) (Package Paths), [`sky130/cells.py`](https://github.com/gdsfactory/skywater130/blob/main/sky130/cells.py) (Fixed Cells)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pdk["PDK Setup"]
  node_pdk_api["PDK Activation<br/>[__init__.py]"]
  node_config["Package Paths<br/>[config.py]"]
end

subgraph group_cells["Cell Libraries"]
  node_fixed_cells["Fixed Cells<br/>[cells.py]"]
  node_logic_cells["Logic Cells<br/>[__init__.py]"]
  node_analog_fixed["Analog Fixed Cells<br/>[__init__.py]"]
  node_mosfets["MOSFET Generators<br/>[mosfets.py]"]
  node_resistors["Resistor Generators<br/>[resistors.py]"]
  node_bjts["BJT Generators<br/>[bjts.py]"]
  node_diodes["Diode Generators<br/>[diodes.py]"]
  node_capacitors["Capacitor Generators<br/>[capacitors.py]"]
  node_contacts["Contact Arrays<br/>[contact.py]"]
  node_other_pcells["Other PCells"]
end

subgraph group_layout["Layout Technology"]
  node_layers["Process Layers<br/>[layers.py]"]
  node_routing["Obstacle Routing<br/>[routing.py]"]
  node_routing_utils["Routing Utilities<br/>[routing_utils.py]"]
  node_technology["Technology Setup<br/>[tech.py]"]
end

subgraph group_models["Device Models"]
  node_spice["SPICE Models<br/>[spice_models.py]"]
  node_model_data["Model Constraints<br/>[constraints.json]"]
end

node_designer(("Chip Designer"))
node_klayout["KLayout"]

node_designer -.->|"imports"| node_pdk_api
node_pdk_api -->|"registers"| node_fixed_cells
node_pdk_api -->|"registers"| node_logic_cells
node_pdk_api -->|"registers"| node_analog_fixed
node_pdk_api -->|"registers"| node_other_pcells
node_pdk_api -->|"configures"| node_layers
node_pdk_api -->|"loads"| node_technology
node_fixed_cells -->|"reads paths"| node_config
node_fixed_cells -->|"uses layers"| node_layers
node_logic_cells -->|"reads paths"| node_config
node_logic_cells -->|"uses layers"| node_layers
node_analog_fixed -->|"reads paths"| node_config
node_analog_fixed -->|"uses layers"| node_layers
node_mosfets -->|"draws layers"| node_layers
node_resistors -->|"draws layers"| node_layers
node_bjts -->|"draws layers"| node_layers
node_bjts -->|"uses arrays"| node_contacts
node_diodes -->|"draws layers"| node_layers
node_diodes -->|"uses arrays"| node_contacts
node_capacitors -->|"uses layers"| node_layers
node_contacts -->|"uses layers"| node_layers
node_other_pcells -.->|"uses layers"| node_layers
node_technology -->|"configures"| node_layers
node_technology -->|"configures"| node_routing
node_routing_utils -->|"uses vias"| node_other_pcells
node_spice -->|"reads paths"| node_config
node_pdk_api -.->|"enables technology"| node_klayout

click node_pdk_api "https://github.com/gdsfactory/skywater130/blob/main/sky130/__init__.py"
click node_config "https://github.com/gdsfactory/skywater130/blob/main/sky130/config.py"
click node_fixed_cells "https://github.com/gdsfactory/skywater130/blob/main/sky130/cells.py"
click node_logic_cells "https://github.com/gdsfactory/skywater130/blob/main/sky130/logic/__init__.py"
click node_analog_fixed "https://github.com/gdsfactory/skywater130/blob/main/sky130/fixed/__init__.py"
click node_mosfets "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/mosfets.py"
click node_resistors "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/resistors.py"
click node_bjts "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/bjts.py"
click node_diodes "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/diodes.py"
click node_capacitors "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/capacitors.py"
click node_contacts "https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/contact.py"
click node_other_pcells "https://github.com/gdsfactory/skywater130/tree/main/sky130/pcells"
click node_layers "https://github.com/gdsfactory/skywater130/blob/main/sky130/layers.py"
click node_routing "https://github.com/gdsfactory/skywater130/blob/main/sky130/routing.py"
click node_routing_utils "https://github.com/gdsfactory/skywater130/blob/main/sky130/routing_utils.py"
click node_technology "https://github.com/gdsfactory/skywater130/blob/main/sky130/tech.py"
click node_spice "https://github.com/gdsfactory/skywater130/blob/main/sky130/spice_models.py"
click node_model_data "https://github.com/gdsfactory/skywater130/blob/main/sky130/model/constraints.json"

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_pdk_api,node_config toneBlue
class node_fixed_cells,node_logic_cells,node_analog_fixed,node_mosfets,node_resistors,node_bjts,node_diodes,node_capacitors,node_contacts,node_other_pcells toneAmber
class node_layers,node_routing,node_routing_utils,node_technology toneMint
class node_spice,node_model_data toneRose
class node_designer,node_klayout toneIndigo
```

## Components

### PDK Setup

- [PDK Activation](https://github.com/gdsfactory/skywater130/blob/main/sky130/__init__.py): `sky130/__init__.py`
- [Package Paths](https://github.com/gdsfactory/skywater130/blob/main/sky130/config.py): `sky130/config.py`

### Cell Libraries

- [Fixed Cells](https://github.com/gdsfactory/skywater130/blob/main/sky130/cells.py): `sky130/cells.py`
- [Logic Cells](https://github.com/gdsfactory/skywater130/blob/main/sky130/logic/__init__.py): `sky130/logic/__init__.py`
- [Analog Fixed Cells](https://github.com/gdsfactory/skywater130/blob/main/sky130/fixed/__init__.py): `sky130/fixed/__init__.py`
- [MOSFET Generators](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/mosfets.py): `sky130/pcells/mosfets.py`
- [Resistor Generators](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/resistors.py): `sky130/pcells/resistors.py`
- [BJT Generators](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/bjts.py): `sky130/pcells/bjts.py`
- [Diode Generators](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/diodes.py): `sky130/pcells/diodes.py`
- [Capacitor Generators](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/capacitors.py): `sky130/pcells/capacitors.py`
- [Contact Arrays](https://github.com/gdsfactory/skywater130/blob/main/sky130/pcells/contact.py): `sky130/pcells/contact.py`
- [Other PCells](https://github.com/gdsfactory/skywater130/tree/main/sky130/pcells): `sky130/pcells`

### Layout Technology

- [Process Layers](https://github.com/gdsfactory/skywater130/blob/main/sky130/layers.py): `sky130/layers.py`
- [Obstacle Routing](https://github.com/gdsfactory/skywater130/blob/main/sky130/routing.py): `sky130/routing.py`
- [Routing Utilities](https://github.com/gdsfactory/skywater130/blob/main/sky130/routing_utils.py): `sky130/routing_utils.py`
- [Technology Setup](https://github.com/gdsfactory/skywater130/blob/main/sky130/tech.py): `sky130/tech.py`

### Device Models

- [SPICE Models](https://github.com/gdsfactory/skywater130/blob/main/sky130/spice_models.py): `sky130/spice_models.py`
- [Model Constraints](https://github.com/gdsfactory/skywater130/blob/main/sky130/model/constraints.json): `sky130/model/constraints.json`

### Other components

- **Chip Designer**
- **KLayout**

## Connections

- Chip Designer → PDK Activation: imports
- PDK Activation → Fixed Cells: registers (evidence: `sky130/__init__.py`)
- PDK Activation → Logic Cells: registers (evidence: `sky130/__init__.py`)
- PDK Activation → Analog Fixed Cells: registers (evidence: `sky130/__init__.py`)
- PDK Activation → Other PCells: registers (evidence: `sky130/__init__.py`)
- PDK Activation → Process Layers: configures (evidence: `sky130/__init__.py`)
- PDK Activation → Technology Setup: loads (evidence: `sky130/__init__.py`)
- Fixed Cells → Package Paths: reads paths (evidence: `sky130/cells.py`)
- Fixed Cells → Process Layers: uses layers (evidence: `sky130/cells.py`)
- Logic Cells → Package Paths: reads paths (evidence: `sky130/logic/__init__.py`)
- Logic Cells → Process Layers: uses layers (evidence: `sky130/logic/__init__.py`)
- Analog Fixed Cells → Package Paths: reads paths (evidence: `sky130/fixed/__init__.py`)
- Analog Fixed Cells → Process Layers: uses layers (evidence: `sky130/fixed/__init__.py`)
- MOSFET Generators → Process Layers: draws layers (evidence: `sky130/pcells/mosfets.py`)
- Resistor Generators → Process Layers: draws layers (evidence: `sky130/pcells/resistors.py`)
- BJT Generators → Process Layers: draws layers (evidence: `sky130/pcells/bjts.py`)
- BJT Generators → Contact Arrays: uses arrays (evidence: `sky130/pcells/bjts.py`)
- Diode Generators → Process Layers: draws layers (evidence: `sky130/pcells/diodes.py`)
- Diode Generators → Contact Arrays: uses arrays (evidence: `sky130/pcells/diodes.py`)
- Capacitor Generators → Process Layers: uses layers (evidence: `sky130/pcells/capacitors.py`)
- Contact Arrays → Process Layers: uses layers (evidence: `sky130/pcells/contact.py`)
- Other PCells → Process Layers: uses layers (evidence: `sky130/pcells/mosfets.py`)
- Technology Setup → Process Layers: configures (evidence: `sky130/tech.py`)
- Technology Setup → Obstacle Routing: configures (evidence: `sky130/tech.py`)
- Routing Utilities → Other PCells: uses vias (evidence: `sky130/routing_utils.py`)
- SPICE Models → Package Paths: reads paths (evidence: `sky130/spice_models.py`)
- PDK Activation → KLayout: enables technology
