# iamadarshsomehow/conceptual-reactor-research-by-adarsh architecture

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

- Interactive diagram: https://gitdiagram.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh
- Repository: https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh

## Overview

This repository is a conceptual reactor research study, not an operational reactor system. Its principal workflow develops STEP geometry for neutronics modeling, evaluates baseline and coolant/drain cases, exports an axial power profile, and uses that profile in a separate one-dimensional thermal-hydraulics analysis; the coupling is one-way. The README also documents voiding and a simplified RBMK comparison. Geometry conversion inputs and generated DAGMC geometry are not fully preserved, and some workflow paths need adjustment, so several links reflect documented intent rather than a runnable end-to-end pipeline.

Main entry points: [`thermal_hydraulics/src/channel.py`](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/channel.py) (Channel model), [`neutronics/src/model.py`](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/src/model.py) (Core model), [`thermal_hydraulics/src/power_scan.py`](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/power_scan.py) (Power sensitivity scan), [`neutronics/results`](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/neutronics/results) (Neutronics results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_geometry["Geometry development"]
  node_step_cad["STEP geometry"]
  node_dagmc["DAGMC geometry"]
end

subgraph group_neutronics["Neutronics analysis"]
  node_base_model["Core model<br/>[model.py]"]
  node_drain_cases["Drain and LOCA<br/>[drain_runs.py]"]
  node_case_sweep["Void and drain sweep<br/>[sweep_all.py]"]
  node_rbmk_benchmark["RBMK comparison<br/>[rbmkv2.py]"]
  node_neutronics_results[("Neutronics results")]
end

subgraph group_coupling["Power handoff"]
  node_profile_export["Axial profile export"]
  node_power_profile["Axial power profile"]
end

subgraph group_thermal["Thermal hydraulics"]
  node_th_config["Channel inputs<br/>[config.yaml]"]
  node_power_map["Power map<br/>[power_map.csv]"]
  node_channel_model["Channel model<br/>[channel.py]"]
  node_water_props["Water properties<br/>[props.py]"]
  node_case_runner["Case runner<br/>[run_cases.py]"]
  node_power_scan["Power sensitivity scan<br/>[power_scan.py]"]
  node_th_results[("Thermal results")]
end

node_researcher(("Researcher"))

node_researcher -->|"develops"| node_step_cad
node_step_cad -.->|"converted toward"| node_dagmc
node_dagmc -.->|"supplies geometry"| node_base_model
node_researcher -->|"runs study"| node_base_model
node_researcher -->|"runs cases"| node_drain_cases
node_researcher -->|"runs sweep"| node_case_sweep
node_researcher -->|"compares against"| node_rbmk_benchmark
node_base_model -.->|"produces results"| node_neutronics_results
node_drain_cases -.->|"saves case results"| node_neutronics_results
node_case_sweep -.->|"saves sweep results"| node_neutronics_results
node_base_model -.->|"provides tally input"| node_profile_export
node_profile_export -->|"writes profile"| node_power_profile
node_power_profile -.->|"drives power shape"| node_channel_model
node_th_config -.->|"configures"| node_channel_model
node_power_map -.->|"supplies power shape"| node_channel_model
node_channel_model -->|"calls property routines"| node_water_props
node_researcher -.->|"runs cases"| node_case_runner
node_researcher -->|"runs sensitivity scan"| node_power_scan
node_power_scan -->|"runs repeatedly"| node_channel_model
node_channel_model -.->|"writes outputs"| node_th_results
node_power_scan -.->|"writes scan results"| node_th_results

click node_step_cad "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/development/geometry"
click node_base_model "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/src/model.py"
click node_drain_cases "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/workflows/drain_runs.py"
click node_case_sweep "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/workflows/sweep_all.py"
click node_rbmk_benchmark "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/development/versions/rbmkagain/rbmkv2.py"
click node_neutronics_results "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/neutronics/results"
click node_profile_export "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/src/export_axial_profile.py"
click node_power_profile "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/data/axial_power_profile.csv"
click node_th_config "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/config/config.yaml"
click node_power_map "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/data/power_map.csv"
click node_channel_model "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/channel.py"
click node_water_props "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/props.py"
click node_case_runner "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/run_cases.py"
click node_power_scan "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/power_scan.py"
click node_th_results "https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/thermal_hydraulics/results"

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_step_cad,node_dagmc toneBlue
class node_base_model,node_drain_cases,node_case_sweep,node_rbmk_benchmark,node_neutronics_results toneAmber
class node_profile_export,node_power_profile toneMint
class node_th_config,node_power_map,node_channel_model,node_water_props,node_case_runner,node_power_scan,node_th_results toneRose
class node_researcher toneIndigo
```

## Components

### Geometry development

- [STEP geometry](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/development/geometry): `development/geometry`
- **DAGMC geometry**

### Neutronics analysis

- [Core model](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/src/model.py): `neutronics/src/model.py`
- [Drain and LOCA](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/workflows/drain_runs.py): `neutronics/workflows/drain_runs.py`
- [Void and drain sweep](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/workflows/sweep_all.py): `neutronics/workflows/sweep_all.py`
- [RBMK comparison](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/development/versions/rbmkagain/rbmkv2.py): `development/versions/rbmkagain/rbmkv2.py`
- [Neutronics results](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/neutronics/results): `neutronics/results`

### Power handoff

- [Axial profile export](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/src/export_axial_profile.py): `neutronics/src/export_axial_profile.py`
- [Axial power profile](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/neutronics/data/axial_power_profile.csv): `neutronics/data/axial_power_profile.csv`

### Thermal hydraulics

- [Channel inputs](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/config/config.yaml): `thermal_hydraulics/config/config.yaml`
- [Power map](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/data/power_map.csv): `thermal_hydraulics/data/power_map.csv`
- [Channel model](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/channel.py): `thermal_hydraulics/src/channel.py`
- [Water properties](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/props.py): `thermal_hydraulics/src/props.py`
- [Case runner](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/run_cases.py): `thermal_hydraulics/src/run_cases.py`
- [Power sensitivity scan](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/blob/main/thermal_hydraulics/src/power_scan.py): `thermal_hydraulics/src/power_scan.py`
- [Thermal results](https://github.com/iamadarshsomehow/conceptual-reactor-research-by-adarsh/tree/main/thermal_hydraulics/results): `thermal_hydraulics/results`

### Other components

- **Researcher**

## Connections

- Researcher → STEP geometry: develops (evidence: `README.md`)
- STEP geometry → DAGMC geometry: converted toward (evidence: `README.md`)
- DAGMC geometry → Core model: supplies geometry (evidence: `README.md`)
- Researcher → Core model: runs study (evidence: `README.md`)
- Researcher → Drain and LOCA: runs cases (evidence: `neutronics/workflows/drain_runs.py`)
- Researcher → Void and drain sweep: runs sweep (evidence: `neutronics/workflows/sweep_all.py`)
- Researcher → RBMK comparison: compares against (evidence: `README.md`)
- Core model → Neutronics results: produces results (evidence: `README.md`)
- Drain and LOCA → Neutronics results: saves case results (evidence: `README.md`)
- Void and drain sweep → Neutronics results: saves sweep results (evidence: `README.md`)
- Core model → Axial profile export: provides tally input (evidence: `README.md`)
- Axial profile export → Axial power profile: writes profile (evidence: `neutronics/src/export_axial_profile.py`)
- Axial power profile → Channel model: drives power shape (evidence: `README.md`)
- Channel inputs → Channel model: configures (evidence: `README.md`)
- Power map → Channel model: supplies power shape (evidence: `README.md`)
- Channel model → Water properties: calls property routines (evidence: `thermal_hydraulics/src/channel.py`)
- Researcher → Case runner: runs cases (evidence: `README.md`)
- Researcher → Power sensitivity scan: runs sensitivity scan (evidence: `thermal_hydraulics/src/power_scan.py`)
- Power sensitivity scan → Channel model: runs repeatedly (evidence: `thermal_hydraulics/src/power_scan.py`)
- Channel model → Thermal results: writes outputs (evidence: `README.md`)
- Power sensitivity scan → Thermal results: writes scan results (evidence: `README.md`)
