# desnault/interval-monte-carlo-method architecture

> Architecture diagram of the GitHub repository desnault/interval-monte-carlo-method, 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/desnault/interval-monte-carlo-method
- Repository: https://github.com/desnault/interval-monte-carlo-method

## Overview

IMCM estimates conservative probability bounds for uncertain mission outcomes using three-valued classification. In the OCEANS 2025 workflow, Python simulates noisy and reference AUV trajectories, C++ classifies each mission against object regions and accumulates per-object and joint bounds, and Python presents the exported results. The repository also includes a generic estimator and box-inclusion classifier, plus trajectory visualization. Edges follow excerpted calls or explicit README descriptions; unsampled details are omitted.

Main entry points: [`oceans2025/main.cpp`](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp) (Mission evaluator), [`oceans2025/result.py`](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/result.py) (Result plots), [`data/main.py`](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py) (Trajectory exports), [`data/display_trajectories.py`](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/display_trajectories.py) (Trajectory viewer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Trajectory simulation"]
  node_sim_cli["Simulation CLI<br/>[main.py]"]
  node_dubins["Noisy Dubins model<br/>[main.py]"]
  node_dubins_runtime["Dubins simulator<br/>[dubins_car.py]"]
  node_trajectory_files["Trajectory exports<br/>[main.py]"]
end

subgraph group_analysis["Mission analysis"]
  node_mission_runner["Mission evaluator<br/>[main.cpp]"]
  node_mission_classifier["AUV mission classifier<br/>[main.cpp]"]
  node_probability_exports["Probability bounds<br/>[main.cpp]"]
end

subgraph group_core["IMCM core"]
  node_box_classifier["Box inclusion"]
  node_estimator["Interval estimator"]
end

subgraph group_presentation["Visualization"]
  node_trajectory_display["Trajectory viewer"]
  node_result_analysis["Result plots<br/>[result.py]"]
end

node_user(("Research user"))
node_user_results(("Analysis output"))

node_user -->|"runs"| node_sim_cli
node_sim_cli -->|"configures"| node_dubins
node_dubins -->|"simulates with"| node_dubins_runtime
node_sim_cli -->|"exports"| node_trajectory_files
node_user -.->|"runs"| node_mission_runner
node_mission_runner -->|"loads"| node_trajectory_files
node_mission_runner -->|"classifies"| node_mission_classifier
node_mission_classifier -->|"uses"| node_box_classifier
node_mission_runner -->|"processes samples"| node_estimator
node_mission_runner -->|"writes"| node_probability_exports
node_user -->|"runs"| node_trajectory_display
node_trajectory_display -->|"loads"| node_trajectory_files
node_user -->|"runs"| node_result_analysis
node_result_analysis -->|"reads"| node_probability_exports
node_result_analysis -->|"reads"| node_trajectory_files
node_result_analysis -->|"plots and reports"| node_user_results

click node_sim_cli "https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py"
click node_dubins "https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py"
click node_dubins_runtime "https://github.com/desnault/interval-monte-carlo-method/blob/main/data/dubins_car.py"
click node_trajectory_files "https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py"
click node_mission_runner "https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp"
click node_mission_classifier "https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp"
click node_box_classifier "https://github.com/desnault/interval-monte-carlo-method/blob/main/src/BoxInclusionClassifier/BoxInclusionClassifier.cpp"
click node_estimator "https://github.com/desnault/interval-monte-carlo-method/blob/main/src/IntervalMonteCarlo/IntervalMonteCarlo.h"
click node_probability_exports "https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp"
click node_trajectory_display "https://github.com/desnault/interval-monte-carlo-method/blob/main/data/display_trajectories.py"
click node_result_analysis "https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/result.py"

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_sim_cli,node_dubins,node_dubins_runtime,node_trajectory_files,node_user toneBlue
class node_mission_runner,node_mission_classifier,node_probability_exports toneAmber
class node_box_classifier,node_estimator toneMint
class node_trajectory_display,node_result_analysis toneRose
class node_user_results toneIndigo
```

## Components

### Trajectory simulation

- [Simulation CLI](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py): `data/main.py`
- [Noisy Dubins model](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py): `data/main.py`
- [Dubins simulator](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/dubins_car.py): `data/dubins_car.py`
- [Trajectory exports](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/main.py): `data/main.py`

### Mission analysis

- [Mission evaluator](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp): `oceans2025/main.cpp`
- [AUV mission classifier](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp): `oceans2025/main.cpp`
- [Probability bounds](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/main.cpp): `oceans2025/main.cpp`

### IMCM core

- [Box inclusion](https://github.com/desnault/interval-monte-carlo-method/blob/main/src/BoxInclusionClassifier/BoxInclusionClassifier.cpp): `src/BoxInclusionClassifier/BoxInclusionClassifier.cpp`
- [Interval estimator](https://github.com/desnault/interval-monte-carlo-method/blob/main/src/IntervalMonteCarlo/IntervalMonteCarlo.h): `src/IntervalMonteCarlo/IntervalMonteCarlo.h`

### Visualization

- [Trajectory viewer](https://github.com/desnault/interval-monte-carlo-method/blob/main/data/display_trajectories.py): `data/display_trajectories.py`
- [Result plots](https://github.com/desnault/interval-monte-carlo-method/blob/main/oceans2025/result.py): `oceans2025/result.py`

### Other components

- **Research user**
- **Analysis output**

## Connections

- Research user → Simulation CLI: runs (evidence: `data/main.py`)
- Simulation CLI → Noisy Dubins model: configures (evidence: `data/main.py`)
- Noisy Dubins model → Dubins simulator: simulates with (evidence: `data/main.py`)
- Simulation CLI → Trajectory exports: exports (evidence: `data/main.py`)
- Research user → Mission evaluator: runs
- Mission evaluator → Trajectory exports: loads (evidence: `oceans2025/main.cpp`)
- Mission evaluator → AUV mission classifier: classifies (evidence: `oceans2025/main.cpp`)
- AUV mission classifier → Box inclusion: uses (evidence: `oceans2025/main.cpp`)
- Mission evaluator → Interval estimator: processes samples (evidence: `oceans2025/main.cpp`)
- Mission evaluator → Probability bounds: writes (evidence: `oceans2025/main.cpp`)
- Research user → Trajectory viewer: runs (evidence: `data/display_trajectories.py`)
- Trajectory viewer → Trajectory exports: loads (evidence: `data/display_trajectories.py`)
- Research user → Result plots: runs (evidence: `oceans2025/result.py`)
- Result plots → Probability bounds: reads (evidence: `oceans2025/result.py`)
- Result plots → Trajectory exports: reads (evidence: `oceans2025/result.py`)
- Result plots → Analysis output: plots and reports (evidence: `oceans2025/result.py`)
