# safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation architecture

> Architecture diagram of the GitHub repository safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation, 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/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation
- Repository: https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation

## Overview

The README describes an RL-guided verification loop: a UVM simulation produces coverage feedback, an agent selects the next stimulus, and results are compared with constrained-random verification. The checked-in tree does not contain the README’s described rl/, integration/, or UVM source directories; it contains iDMA RTL and otherwise sparse support directories. Accordingly, the workflow below is documented rather than source-verified, and README.md is the evidence for its relationships.

Main entry points: [`README.md`](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md) (RL agent), [`rtl/idma_generated.sv`](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/rtl/idma_generated.sv) (iDMA RTL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["RL control"]
  node_agent["RL agent<br/>[README.md]"]
  node_state["State building<br/>[README.md]"]
  node_policy["Action selection<br/>[README.md]"]
  node_reward["Coverage reward<br/>[README.md]"]
  node_mapping["Stimulus mapping<br/>[README.md]"]
end

subgraph group_verification["Verification"]
  node_coverage["Coverage report<br/>[README.md]"]
  node_stimulus["Applied stimulus<br/>[README.md]"]
  node_budget["Run budget<br/>[README.md]"]
  node_simulation["UVM simulation<br/>[README.md]"]
end

subgraph group_dut["Design under test"]
  node_idma["iDMA RTL<br/>[idma_generated.sv]"]
end

subgraph group_evaluation["Evaluation"]
  node_baseline["Constrained-random<br/>[README.md]"]
  node_comparison["Coverage and cost comparison<br/>[README.md]"]
end

node_simulation -->|"produces"| node_coverage
node_simulation -->|"records"| node_stimulus
node_agent -->|"reads"| node_coverage
node_agent -->|"reads"| node_stimulus
node_agent -->|"reads"| node_budget
node_agent -->|"builds"| node_state
node_agent -->|"selects through"| node_policy
node_agent -->|"scores progress with"| node_reward
node_agent -->|"maps actions through"| node_mapping
node_mapping -->|"sets stimulus for"| node_simulation
node_simulation -->|"verifies"| node_idma
node_baseline -->|"provides baseline"| node_comparison
node_simulation -->|"provides RL results"| node_comparison

click node_coverage "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_stimulus "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_budget "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_agent "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_state "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_policy "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_reward "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_mapping "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_simulation "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_idma "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/rtl/idma_generated.sv"
click node_baseline "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"
click node_comparison "https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md"

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_agent,node_state,node_policy,node_reward,node_mapping toneBlue
class node_coverage,node_stimulus,node_budget,node_simulation toneAmber
class node_idma toneMint
class node_baseline,node_comparison toneRose
```

## Components

### RL control

- [RL agent](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [State building](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Action selection](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Coverage reward](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Stimulus mapping](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`

### Verification

- [Coverage report](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Applied stimulus](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Run budget](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [UVM simulation](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`

### Design under test

- [iDMA RTL](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/rtl/idma_generated.sv): `rtl/idma_generated.sv`

### Evaluation

- [Constrained-random](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`
- [Coverage and cost comparison](https://github.com/safie-tarek/accelerating_digital_verification_using_ai-based_constrained_stimulus_generation/blob/main/README.md): `README.md`

## Connections

- UVM simulation → Coverage report: produces (evidence: `README.md`)
- UVM simulation → Applied stimulus: records (evidence: `README.md`)
- RL agent → Coverage report: reads (evidence: `README.md`)
- RL agent → Applied stimulus: reads (evidence: `README.md`)
- RL agent → Run budget: reads (evidence: `README.md`)
- RL agent → State building: builds (evidence: `README.md`)
- RL agent → Action selection: selects through (evidence: `README.md`)
- RL agent → Coverage reward: scores progress with (evidence: `README.md`)
- RL agent → Stimulus mapping: maps actions through (evidence: `README.md`)
- Stimulus mapping → UVM simulation: sets stimulus for (evidence: `README.md`)
- UVM simulation → iDMA RTL: verifies (evidence: `README.md`)
- Constrained-random → Coverage and cost comparison: provides baseline (evidence: `README.md`)
- UVM simulation → Coverage and cost comparison: provides RL results (evidence: `README.md`)
