# simotmm/atpg_rust_tesi architecture

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

- Interactive diagram: https://gitdiagram.com/simotmm/atpg_rust_tesi
- Repository: https://github.com/simotmm/atpg_rust_tesi

## Overview

This repository contains a Rust ATPG generator, the Atalanta family of ATPG and fault-simulation engines, and a small commutation-maximization utility. The principal Rust workflow takes a circuit file through parsing and netlist modeling, then uses ATPG/SAT and parallel fault simulation to generate and assess test patterns; utilities can save patterns and fault-list results. Atalanta provides a separate pattern-simulation and validation path. The graph also preserves the Espresso Boolean-cover package and the transition-maximization tool. Relationships are limited to those documented in the README or visible in the supplied excerpts and source index.

Main entry points: [`atpg_rust/main.rs`](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/main.rs) (Rust CLI), [`commutations_maximizer/src/main.rs`](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/main.rs) (Maximizer CLI), [`atpg_rust/sat.rs`](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/sat.rs) (SAT ATPG), [`atpg_atlanta/Atalanta/sim.cpp`](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/sim.cpp) (Simulation Dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rust["Rust ATPG"]
  node_rust_cli["Rust CLI<br/>[main.rs]"]
  node_parser["Circuit Parsers<br/>[parser.rs]"]
  node_netlist["Netlist Model<br/>[netlist.rs]"]
  node_dag["Circuit DAG<br/>[dag.rs]"]
  node_sat["SAT ATPG<br/>[sat.rs]"]
  node_ppsfp["Fault Simulation<br/>[ppsfp.rs]"]
  node_pattern["Pattern Generation"]
  node_rust_util["Pattern Utilities<br/>[util.rs]"]
end

subgraph group_atlanta["Atalanta Engines"]
  node_atlanta_cli["Atalanta Runner<br/>[atalanta.cpp]"]
  node_atlanta_fan["FAN ATPG<br/>[fan.cpp]"]
  node_atlanta_sim["Simulation Dispatcher<br/>[sim.cpp]"]
  node_atlanta_fsim["Fault Simulator<br/>[fsim.cpp]"]
  node_atlanta_ppsfp["Parallel Simulation<br/>[ppsfp.cpp]"]
end

subgraph group_espresso["Boolean Cover"]
  node_espresso_api["Cover API<br/>[main.ts]"]
  node_espresso_engine["Espresso Minimizer<br/>[espresso.ts]"]
  node_cube["Cube Representation<br/>[cube.ts]"]
end

subgraph group_commute["Transition Maximizer"]
  node_commute_cli["Maximizer CLI<br/>[main.rs]"]
  node_commute_parser["Verilog Parser<br/>[parser.rs]"]
  node_commute_netlist["Netlist Model<br/>[netlist.rs]"]
  node_commute_patterns["Input Combinations"]
  node_commute_sim["Transition Analysis<br/>[ppsfp.rs]"]
end

node_user(("Engineer"))
node_result["Pattern / Results"]

node_user -->|"runs"| node_rust_cli
node_rust_cli -->|"parses circuit"| node_parser
node_parser -->|"builds model"| node_netlist
node_rust_cli -->|"runs ATPG"| node_sat
node_rust_cli -->|"simulates patterns"| node_ppsfp
node_rust_cli -->|"saves results"| node_rust_util
node_sat -->|"builds test formula"| node_dag
node_sat -->|"uses circuit"| node_netlist
node_sat -->|"uses fault model"| node_ppsfp
node_ppsfp -->|"evaluates circuit"| node_dag
node_ppsfp -->|"uses gate types"| node_netlist
node_rust_cli -->|"generates patterns"| node_pattern
node_rust_cli -->|"writes"| node_result
node_user -->|"runs validation"| node_atlanta_cli
node_atlanta_cli -.->|"dispatches simulation"| node_atlanta_sim
node_atlanta_sim -->|"uses fault simulation"| node_atlanta_fsim
node_atlanta_sim -->|"uses parallel simulation"| node_atlanta_ppsfp
node_atlanta_sim -->|"uses FAN"| node_atlanta_fan
node_atlanta_cli -->|"validates patterns"| node_result
node_espresso_api -->|"converts cubes"| node_cube
node_espresso_api -->|"minimizes cover"| node_espresso_engine
node_espresso_engine -->|"operates on cubes"| node_cube
node_user -->|"runs analysis"| node_commute_cli
node_commute_cli -->|"parses circuit"| node_commute_parser
node_commute_parser -->|"builds model"| node_commute_netlist
node_commute_cli -->|"generates combinations"| node_commute_patterns
node_commute_cli -->|"analyzes transitions"| node_commute_sim
node_commute_patterns -->|"uses circuit"| node_commute_netlist
node_commute_sim -->|"evaluates circuit"| node_commute_netlist
node_commute_cli -->|"saves bit pair"| node_result

click node_rust_cli "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/main.rs"
click node_parser "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/parser.rs"
click node_netlist "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/netlist.rs"
click node_dag "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/dag.rs"
click node_sat "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/sat.rs"
click node_ppsfp "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/ppsfp.rs"
click node_pattern "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/pattern_generator.rs"
click node_rust_util "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/util.rs"
click node_atlanta_cli "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/atalanta.cpp"
click node_atlanta_fan "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/fan.cpp"
click node_atlanta_sim "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/sim.cpp"
click node_atlanta_fsim "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/fsim.cpp"
click node_atlanta_ppsfp "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/ppsfp.cpp"
click node_espresso_api "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/main.ts"
click node_espresso_engine "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/espresso.ts"
click node_cube "https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/cube.ts"
click node_commute_cli "https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/main.rs"
click node_commute_parser "https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/parser.rs"
click node_commute_netlist "https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/netlist.rs"
click node_commute_patterns "https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/pattern_generator.rs"
click node_commute_sim "https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/ppsfp.rs"

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_rust_cli,node_parser,node_netlist,node_dag,node_sat,node_ppsfp,node_pattern,node_rust_util toneBlue
class node_atlanta_cli,node_atlanta_fan,node_atlanta_sim,node_atlanta_fsim,node_atlanta_ppsfp toneAmber
class node_espresso_api,node_espresso_engine,node_cube toneMint
class node_commute_cli,node_commute_parser,node_commute_netlist,node_commute_patterns,node_commute_sim toneRose
class node_user,node_result toneIndigo
```

## Components

### Rust ATPG

- [Rust CLI](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/main.rs): `atpg_rust/main.rs`
- [Circuit Parsers](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/parser.rs): `atpg_rust/parser.rs`
- [Netlist Model](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/netlist.rs): `atpg_rust/netlist.rs`
- [Circuit DAG](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/dag.rs): `atpg_rust/dag.rs`
- [SAT ATPG](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/sat.rs): `atpg_rust/sat.rs`
- [Fault Simulation](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/ppsfp.rs): `atpg_rust/ppsfp.rs`
- [Pattern Generation](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/pattern_generator.rs): `atpg_rust/pattern_generator.rs`
- [Pattern Utilities](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/util.rs): `atpg_rust/util.rs`

### Atalanta Engines

- [Atalanta Runner](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/atalanta.cpp): `atpg_atlanta/Atalanta/atalanta.cpp`
- [FAN ATPG](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/fan.cpp): `atpg_atlanta/Atalanta/fan.cpp`
- [Simulation Dispatcher](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/sim.cpp): `atpg_atlanta/Atalanta/sim.cpp`
- [Fault Simulator](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/fsim.cpp): `atpg_atlanta/Atalanta/fsim.cpp`
- [Parallel Simulation](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_atlanta/Atalanta/ppsfp.cpp): `atpg_atlanta/Atalanta/ppsfp.cpp`

### Boolean Cover

- [Cover API](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/main.ts): `atpg_rust/espresso-iisojs/src/main.ts`
- [Espresso Minimizer](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/espresso.ts): `atpg_rust/espresso-iisojs/src/espresso.ts`
- [Cube Representation](https://github.com/simotmm/atpg_rust_tesi/blob/main/atpg_rust/espresso-iisojs/src/cube.ts): `atpg_rust/espresso-iisojs/src/cube.ts`

### Transition Maximizer

- [Maximizer CLI](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/main.rs): `commutations_maximizer/src/main.rs`
- [Verilog Parser](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/parser.rs): `commutations_maximizer/src/parser.rs`
- [Netlist Model](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/netlist.rs): `commutations_maximizer/src/netlist.rs`
- [Input Combinations](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/pattern_generator.rs): `commutations_maximizer/src/pattern_generator.rs`
- [Transition Analysis](https://github.com/simotmm/atpg_rust_tesi/blob/main/commutations_maximizer/src/ppsfp.rs): `commutations_maximizer/src/ppsfp.rs`

### Other components

- **Engineer**
- **Pattern / Results**

## Connections

- Engineer → Rust CLI: runs
- Rust CLI → Circuit Parsers: parses circuit (evidence: `atpg_rust/main.rs`)
- Circuit Parsers → Netlist Model: builds model (evidence: `atpg_rust/parser.rs`)
- Rust CLI → SAT ATPG: runs ATPG (evidence: `atpg_rust/main.rs`)
- Rust CLI → Fault Simulation: simulates patterns (evidence: `atpg_rust/main.rs`)
- Rust CLI → Pattern Utilities: saves results (evidence: `atpg_rust/main.rs`)
- SAT ATPG → Circuit DAG: builds test formula (evidence: `atpg_rust/sat.rs`)
- SAT ATPG → Netlist Model: uses circuit (evidence: `atpg_rust/sat.rs`)
- SAT ATPG → Fault Simulation: uses fault model (evidence: `atpg_rust/sat.rs`)
- Fault Simulation → Circuit DAG: evaluates circuit (evidence: `atpg_rust/ppsfp.rs`)
- Fault Simulation → Netlist Model: uses gate types (evidence: `atpg_rust/ppsfp.rs`)
- Rust CLI → Pattern Generation: generates patterns (evidence: `atpg_rust/main.rs`)
- Rust CLI → Pattern / Results: writes
- Engineer → Atalanta Runner: runs validation
- Atalanta Runner → Simulation Dispatcher: dispatches simulation
- Simulation Dispatcher → Fault Simulator: uses fault simulation (evidence: `atpg_atlanta/Atalanta/sim.cpp`)
- Simulation Dispatcher → Parallel Simulation: uses parallel simulation (evidence: `atpg_atlanta/Atalanta/sim.cpp`)
- Simulation Dispatcher → FAN ATPG: uses FAN (evidence: `atpg_atlanta/Atalanta/sim.cpp`)
- Atalanta Runner → Pattern / Results: validates patterns
- Cover API → Cube Representation: converts cubes (evidence: `atpg_rust/espresso-iisojs/src/main.ts`)
- Cover API → Espresso Minimizer: minimizes cover (evidence: `atpg_rust/espresso-iisojs/src/main.ts`)
- Espresso Minimizer → Cube Representation: operates on cubes (evidence: `atpg_rust/espresso-iisojs/src/espresso.ts`)
- Engineer → Maximizer CLI: runs analysis (evidence: `commutations_maximizer/src/main.rs`)
- Maximizer CLI → Verilog Parser: parses circuit (evidence: `commutations_maximizer/src/main.rs`)
- Verilog Parser → Netlist Model: builds model (evidence: `commutations_maximizer/src/parser.rs`)
- Maximizer CLI → Input Combinations: generates combinations (evidence: `commutations_maximizer/src/main.rs`)
- Maximizer CLI → Transition Analysis: analyzes transitions (evidence: `commutations_maximizer/src/main.rs`)
- Input Combinations → Netlist Model: uses circuit (evidence: `commutations_maximizer/src/pattern_generator.rs`)
- Transition Analysis → Netlist Model: evaluates circuit (evidence: `commutations_maximizer/src/ppsfp.rs`)
- Maximizer CLI → Pattern / Results: saves bit pair (evidence: `commutations_maximizer/src/main.rs`)
