# rpd-512/atlas architecture

> Architecture diagram of the GitHub repository rpd-512/atlas, 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/rpd-512/atlas
- Repository: https://github.com/rpd-512/atlas

## Overview

ATLAS analyzes a technology-mapped netlist against a Liberty cell library. The documented user workflow is RTL design → Yosys synthesis and mapping → JSON netlist → ATLAS analysis and reported metrics. Within ATLAS, the sampled entry point parses both inputs, attaches cell characterization, and runs analysis passes. The README documents the full capability set; unsampled implementation details are represented only where that documentation supports them.

Main entry points: [`main.cpp`](https://github.com/rpd-512/atlas/blob/main/main.cpp) (ATLAS CLI), [`includes/types.h`](https://github.com/rpd-512/atlas/blob/main/includes/types.h) (Circuit model), [`includes/atlas_utils.h`](https://github.com/rpd-512/atlas/blob/main/includes/atlas_utils.h) (Cell attachment), [`rtl`](https://github.com/rpd-512/atlas/tree/main/rtl) (RTL design)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Design inputs"]
  node_rtl["RTL design"]
  node_netlist["Mapped netlist<br/>[netlist.json]"]
  node_liberty["Liberty library"]
end

subgraph group_ingest["Input and characterization"]
  node_entry["ATLAS CLI<br/>[main.cpp]"]
  node_parsers["Input parsers<br/>[io_utils.h]"]
  node_characterization["Cell attachment<br/>[atlas_utils.h]"]
end

subgraph group_analysis["Circuit analysis"]
  node_logic["Logic evaluation<br/>[eval_utils.h]"]
  node_softlogic["Soft evaluation<br/>[soft_eval_utils.h]"]
  node_area["Area analysis<br/>[area_utils.h]"]
  node_timing["Static timing<br/>[sta_utils.h]"]
  node_power["Power estimation<br/>[power_utils.h]"]
end

subgraph group_results["Results and shared model"]
  node_model[("Circuit model<br/>[types.h]")]
  node_reporting["Metrics and output<br/>[main.cpp]"]
end

node_designer(("RTL designer"))
node_yosys["Yosys"]

node_designer -->|"writes"| node_rtl
node_rtl -->|"synthesizes"| node_yosys
node_yosys -->|"generates"| node_netlist
node_netlist -->|"supplied to"| node_entry
node_liberty -->|"supplied to"| node_entry
node_entry -->|"parses inputs"| node_parsers
node_parsers -->|"builds"| node_model
node_entry -->|"attaches data"| node_characterization
node_characterization -->|"updates"| node_model
node_characterization -->|"compiles functions"| node_logic
node_characterization -->|"compiles functions"| node_softlogic
node_entry -->|"evaluates"| node_logic
node_entry -->|"evaluates"| node_softlogic
node_entry -->|"computes area"| node_area
node_entry -->|"runs analysis"| node_timing
node_entry -->|"computes power"| node_power
node_entry -->|"prints results"| node_reporting
node_area -->|"reads gates"| node_model
node_timing -->|"updates timing"| node_model
node_power -->|"reads circuit data"| node_model

click node_rtl "https://github.com/rpd-512/atlas/tree/main/rtl"
click node_netlist "https://github.com/rpd-512/atlas/blob/main/netlist.json"
click node_liberty "https://github.com/rpd-512/atlas/blob/main/liberty/sky130_fd_sc_hd__tt_025C_1v80.lib"
click node_entry "https://github.com/rpd-512/atlas/blob/main/main.cpp"
click node_parsers "https://github.com/rpd-512/atlas/blob/main/includes/io_utils.h"
click node_characterization "https://github.com/rpd-512/atlas/blob/main/includes/atlas_utils.h"
click node_model "https://github.com/rpd-512/atlas/blob/main/includes/types.h"
click node_logic "https://github.com/rpd-512/atlas/blob/main/includes/eval_utils.h"
click node_softlogic "https://github.com/rpd-512/atlas/blob/main/includes/soft_eval_utils.h"
click node_area "https://github.com/rpd-512/atlas/blob/main/includes/area_utils.h"
click node_timing "https://github.com/rpd-512/atlas/blob/main/includes/sta_utils.h"
click node_power "https://github.com/rpd-512/atlas/blob/main/includes/power_utils.h"
click node_reporting "https://github.com/rpd-512/atlas/blob/main/main.cpp"

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_rtl,node_netlist,node_liberty toneBlue
class node_entry,node_parsers,node_characterization toneAmber
class node_logic,node_softlogic,node_area,node_timing,node_power toneMint
class node_model,node_reporting toneRose
class node_designer,node_yosys toneIndigo
```

## Components

### Design inputs

- [RTL design](https://github.com/rpd-512/atlas/tree/main/rtl): `rtl`
- [Mapped netlist](https://github.com/rpd-512/atlas/blob/main/netlist.json): `netlist.json`
- [Liberty library](https://github.com/rpd-512/atlas/blob/main/liberty/sky130_fd_sc_hd__tt_025C_1v80.lib): `liberty/sky130_fd_sc_hd__tt_025C_1v80.lib`

### Input and characterization

- [ATLAS CLI](https://github.com/rpd-512/atlas/blob/main/main.cpp): `main.cpp`
- [Input parsers](https://github.com/rpd-512/atlas/blob/main/includes/io_utils.h): `includes/io_utils.h`
- [Cell attachment](https://github.com/rpd-512/atlas/blob/main/includes/atlas_utils.h): `includes/atlas_utils.h`

### Circuit analysis

- [Logic evaluation](https://github.com/rpd-512/atlas/blob/main/includes/eval_utils.h): `includes/eval_utils.h`
- [Soft evaluation](https://github.com/rpd-512/atlas/blob/main/includes/soft_eval_utils.h): `includes/soft_eval_utils.h`
- [Area analysis](https://github.com/rpd-512/atlas/blob/main/includes/area_utils.h): `includes/area_utils.h`
- [Static timing](https://github.com/rpd-512/atlas/blob/main/includes/sta_utils.h): `includes/sta_utils.h`
- [Power estimation](https://github.com/rpd-512/atlas/blob/main/includes/power_utils.h): `includes/power_utils.h`

### Results and shared model

- [Circuit model](https://github.com/rpd-512/atlas/blob/main/includes/types.h): `includes/types.h`
- [Metrics and output](https://github.com/rpd-512/atlas/blob/main/main.cpp): `main.cpp`

### Other components

- **RTL designer**
- **Yosys**

## Connections

- RTL designer → RTL design: writes (evidence: `README.md`)
- RTL design → Yosys: synthesizes (evidence: `README.md`)
- Yosys → Mapped netlist: generates (evidence: `README.md`)
- Mapped netlist → ATLAS CLI: supplied to (evidence: `README.md`)
- Liberty library → ATLAS CLI: supplied to (evidence: `README.md`)
- ATLAS CLI → Input parsers: parses inputs (evidence: `main.cpp`)
- Input parsers → Circuit model: builds (evidence: `includes/io_utils.h`)
- ATLAS CLI → Cell attachment: attaches data (evidence: `main.cpp`)
- Cell attachment → Circuit model: updates (evidence: `includes/atlas_utils.h`)
- Cell attachment → Logic evaluation: compiles functions (evidence: `includes/atlas_utils.h`)
- Cell attachment → Soft evaluation: compiles functions (evidence: `includes/atlas_utils.h`)
- ATLAS CLI → Logic evaluation: evaluates (evidence: `README.md`)
- ATLAS CLI → Soft evaluation: evaluates (evidence: `README.md`)
- ATLAS CLI → Area analysis: computes area (evidence: `main.cpp`)
- ATLAS CLI → Static timing: runs analysis (evidence: `main.cpp`)
- ATLAS CLI → Power estimation: computes power (evidence: `main.cpp`)
- ATLAS CLI → Metrics and output: prints results (evidence: `main.cpp`)
- Area analysis → Circuit model: reads gates (evidence: `includes/area_utils.h`)
- Static timing → Circuit model: updates timing (evidence: `includes/sta_utils.h`)
- Power estimation → Circuit model: reads circuit data (evidence: `includes/power_utils.h`)
