# pgavriel/moad_cui architecture

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

- Interactive diagram: https://gitdiagram.com/pgavriel/moad_cui
- Repository: https://github.com/pgavriel/moad_cui

## Overview

MOAD CUI is a multi-camera scanning application. The principal workflow is to configure the rig, use its console controls to run a scan, collect enabled camera/sensor data at turntable positions, and save scan metadata. The README also documents calibration and point-cloud/data utilities; Scene Replica features are visible in the menu and script interfaces. Several connections are omitted because the relevant implementation excerpts were not provided.

Main entry points: [`src/MOADCui.cpp`](https://github.com/pgavriel/moad_cui/blob/main-linux/src/MOADCui.cpp) (MOAD application), [`src/ScanManager.cpp`](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScanManager.cpp) (Scan orchestration), [`src/CanonHandler.cpp`](https://github.com/pgavriel/moad_cui/blob/main-linux/src/CanonHandler.cpp) (Canon cameras), [`src/ScriptRunner.cpp`](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScriptRunner.cpp) (Script wrappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Rig control"]
  node_app["MOAD application<br/>[MOADCui.cpp]"]
  node_menus["Console menus<br/>[MenuHandler.cpp]"]
  node_config["Configuration<br/>[ConfigHandler.cpp]"]
  node_logging["Logging<br/>[DebugUtils.h]"]
end

subgraph group_capture["Capture hardware"]
  node_canon["Canon cameras<br/>[CanonHandler.cpp]"]
  node_realsense["RealSense cameras"]
  node_turntable["Turntable serial"]
  node_threads["Worker pool<br/>[ThreadPool.cpp]"]
  node_picture["Picture capture<br/>[TakePicture.cpp]"]
  node_downloads["Image downloads<br/>[Download.cpp]"]
  node_liveview["Live-view download<br/>[DownloadEvf.cpp]"]
end

subgraph group_data["Scan data"]
  node_scan["Scan orchestration<br/>[ScanManager.cpp]"]
  node_scan_output[("Scan output<br/>[ScanManager.cpp]")]
end

subgraph group_tools["Data tools"]
  node_scripts["Script wrappers<br/>[ScriptRunner.cpp]"]
  node_calibration["Calibration tools"]
  node_clouds["Cloud alignment<br/>[align_clouds.py]"]
  node_annotations["Replica annotations"]
  node_replica_view["Replica viewer"]
  node_transform["Transform generation"]
  node_blur["Blur measurement<br/>[measure_blur.py]"]
  node_orbit["Orbit video"]
  node_downloader["ATB downloader<br/>[atb_downloader.py]"]
end

node_operator(("Operator"))
node_external_sdk["Canon EDSDK"]
node_config_file["MOAD config file"]

node_operator -->|"uses"| node_app
node_app -->|"presents controls"| node_menus
node_app -->|"loads settings"| node_config
node_config_file -->|"configures"| node_config
node_app -->|"initializes"| node_canon
node_app -->|"initializes"| node_realsense
node_canon -->|"uses SDK"| node_external_sdk
node_scan -->|"reads settings"| node_config
node_scan -->|"collects frames"| node_realsense
node_scan -->|"moves turntable"| node_turntable
node_scan -->|"uses workers"| node_threads
node_realsense -.->|"queues work"| node_threads
node_scan -.->|"captures pictures"| node_picture
node_canon -.->|"downloads images"| node_downloads
node_canon -.->|"provides live view"| node_liveview
node_scan -->|"writes scan data"| node_scan_output
node_scan -->|"requests transforms"| node_scripts
node_scripts -->|"runs script"| node_transform
node_scripts -->|"runs annotations"| node_annotations
node_app -->|"offers generation"| node_annotations
node_app -.->|"offers scene view"| node_replica_view
node_app -.->|"logs activity"| node_logging

click node_app "https://github.com/pgavriel/moad_cui/blob/main-linux/src/MOADCui.cpp"
click node_menus "https://github.com/pgavriel/moad_cui/blob/main-linux/src/MenuHandler.cpp"
click node_config "https://github.com/pgavriel/moad_cui/blob/main-linux/src/ConfigHandler.cpp"
click node_logging "https://github.com/pgavriel/moad_cui/blob/main-linux/include/DebugUtils.h"
click node_scan "https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScanManager.cpp"
click node_canon "https://github.com/pgavriel/moad_cui/blob/main-linux/src/CanonHandler.cpp"
click node_realsense "https://github.com/pgavriel/moad_cui/blob/main-linux/src/RealSenseHandler.cpp"
click node_turntable "https://github.com/pgavriel/moad_cui/blob/main-linux/src/SerialCommunication.cpp"
click node_threads "https://github.com/pgavriel/moad_cui/blob/main-linux/src/ThreadPool.cpp"
click node_picture "https://github.com/pgavriel/moad_cui/blob/main-linux/src/TakePicture.cpp"
click node_downloads "https://github.com/pgavriel/moad_cui/blob/main-linux/src/Download.cpp"
click node_liveview "https://github.com/pgavriel/moad_cui/blob/main-linux/src/DownloadEvf.cpp"
click node_scripts "https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScriptRunner.cpp"
click node_calibration "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/create_calibration.py"
click node_clouds "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/align_clouds.py"
click node_annotations "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/replica_generate_annotations.py"
click node_replica_view "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/replica_view_annotations.py"
click node_transform "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/transform_generator.py"
click node_blur "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/measure_blur.py"
click node_orbit "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/orbit_video_generator.py"
click node_downloader "https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/atb_downloader.py"
click node_scan_output "https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScanManager.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_app,node_menus,node_config,node_logging toneBlue
class node_canon,node_realsense,node_turntable,node_threads,node_picture,node_downloads,node_liveview toneAmber
class node_scan,node_scan_output toneMint
class node_scripts,node_calibration,node_clouds,node_annotations,node_replica_view,node_transform,node_blur,node_orbit,node_downloader toneRose
class node_operator,node_external_sdk,node_config_file toneIndigo
```

## Components

### Rig control

- [MOAD application](https://github.com/pgavriel/moad_cui/blob/main-linux/src/MOADCui.cpp): `src/MOADCui.cpp`
- [Console menus](https://github.com/pgavriel/moad_cui/blob/main-linux/src/MenuHandler.cpp): `src/MenuHandler.cpp`
- [Configuration](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ConfigHandler.cpp): `src/ConfigHandler.cpp`
- [Logging](https://github.com/pgavriel/moad_cui/blob/main-linux/include/DebugUtils.h): `include/DebugUtils.h`

### Capture hardware

- [Canon cameras](https://github.com/pgavriel/moad_cui/blob/main-linux/src/CanonHandler.cpp): `src/CanonHandler.cpp`
- [RealSense cameras](https://github.com/pgavriel/moad_cui/blob/main-linux/src/RealSenseHandler.cpp): `src/RealSenseHandler.cpp`
- [Turntable serial](https://github.com/pgavriel/moad_cui/blob/main-linux/src/SerialCommunication.cpp): `src/SerialCommunication.cpp`
- [Worker pool](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ThreadPool.cpp): `src/ThreadPool.cpp`
- [Picture capture](https://github.com/pgavriel/moad_cui/blob/main-linux/src/TakePicture.cpp): `src/TakePicture.cpp`
- [Image downloads](https://github.com/pgavriel/moad_cui/blob/main-linux/src/Download.cpp): `src/Download.cpp`
- [Live-view download](https://github.com/pgavriel/moad_cui/blob/main-linux/src/DownloadEvf.cpp): `src/DownloadEvf.cpp`

### Scan data

- [Scan orchestration](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScanManager.cpp): `src/ScanManager.cpp`
- [Scan output](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScanManager.cpp): `src/ScanManager.cpp`

### Data tools

- [Script wrappers](https://github.com/pgavriel/moad_cui/blob/main-linux/src/ScriptRunner.cpp): `src/ScriptRunner.cpp`
- [Calibration tools](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/create_calibration.py): `scripts/create_calibration.py`
- [Cloud alignment](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/align_clouds.py): `scripts/align_clouds.py`
- [Replica annotations](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/replica_generate_annotations.py): `scripts/replica_generate_annotations.py`
- [Replica viewer](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/replica_view_annotations.py): `scripts/replica_view_annotations.py`
- [Transform generation](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/transform_generator.py): `scripts/transform_generator.py`
- [Blur measurement](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/measure_blur.py): `scripts/measure_blur.py`
- [Orbit video](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/orbit_video_generator.py): `scripts/orbit_video_generator.py`
- [ATB downloader](https://github.com/pgavriel/moad_cui/blob/main-linux/scripts/atb_downloader.py): `scripts/atb_downloader.py`

### Other components

- **Operator**
- **Canon EDSDK**
- **MOAD config file**

## Connections

- Operator → MOAD application: uses (evidence: `README.md`)
- MOAD application → Console menus: presents controls (evidence: `src/MOADCui.cpp`)
- MOAD application → Configuration: loads settings (evidence: `src/MOADCui.cpp`)
- MOAD config file → Configuration: configures (evidence: `README.md`)
- MOAD application → Canon cameras: initializes (evidence: `src/MOADCui.cpp`)
- MOAD application → RealSense cameras: initializes (evidence: `src/MOADCui.cpp`)
- Canon cameras → Canon EDSDK: uses SDK
- Scan orchestration → Configuration: reads settings (evidence: `src/ScanManager.cpp`)
- Scan orchestration → RealSense cameras: collects frames (evidence: `src/ScanManager.cpp`)
- Scan orchestration → Turntable serial: moves turntable (evidence: `src/ScanManager.cpp`)
- Scan orchestration → Worker pool: uses workers (evidence: `src/ScanManager.cpp`)
- RealSense cameras → Worker pool: queues work
- Scan orchestration → Picture capture: captures pictures
- Canon cameras → Image downloads: downloads images
- Canon cameras → Live-view download: provides live view
- Scan orchestration → Scan output: writes scan data (evidence: `src/ScanManager.cpp`)
- Scan orchestration → Script wrappers: requests transforms (evidence: `src/ScanManager.cpp`)
- Script wrappers → Transform generation: runs script
- Script wrappers → Replica annotations: runs annotations
- MOAD application → Replica annotations: offers generation (evidence: `src/MOADCui.cpp`)
- MOAD application → Replica viewer: offers scene view
- MOAD application → Logging: logs activity (evidence: `src/MOADCui.cpp`)
