# xbl2602/openrocket-monte-carlo architecture

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

- Interactive diagram: https://gitdiagram.com/xbl2602/openrocket-monte-carlo
- Repository: https://github.com/xbl2602/openrocket-monte-carlo

## Overview

This is an OpenRocket plugin for Monte Carlo rocket-flight analysis, including configurable vehicle, atmosphere, wind, gust/shear, recovery, and motor variability. Users configure a run in the plugin or batch CLI; runs are simulated, extracted into records, summarized and exported as CSV, with a separate 6DOF landing-dispersion KML analysis. The graph preserves the documented GUI, batch, plotting, and sigma-recommendation capabilities. Some implementation paths are supported only by the source index or README, so uncertain internal calls are omitted.

Main entry points: [`src/com/hprc/montecarlo/MonteCarloBatchRunner.java`](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchRunner.java) (Batch runner), [`src/com/hprc/montecarlo/MonteCarloConfigurator.java`](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloConfigurator.java) (Plugin configuration), [`src/com/hprc/montecarlo/MonteCarloBatchCli.java`](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchCli.java) (Batch CLI), [`src/com/hprc/montecarlo/MonteCarloExtension.java`](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloExtension.java) (Run extension)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_gui["Plugin configuration"]
  node_batchcli["Batch CLI"]
  node_config["Batch configuration"]
end

subgraph group_simulation["Simulation"]
  node_extension["Run extension"]
  node_sampling["Parameter sampling"]
  node_paramregistry["Parameter registry<br/>[McParam.java]"]
  node_disturbance["Wind disturbances"]
  node_recovery["Recovery perturbations"]
  node_physics["Physics overrides"]
  node_windstate["Wind state<br/>[WindSnapshot.java]"]
  node_runner["Batch runner"]
  node_orengine["OpenRocket simulator"]
end

subgraph group_analysis["Analysis"]
  node_extract["Flight data extraction"]
  node_record["Run records"]
  node_aggregation["Flight aggregation"]
  node_summary["Batch statistics<br/>[BatchSummary.java]"]
  node_statistics["Statistics<br/>[Statistics.java]"]
  node_sigmarec["Sigma recommendation"]
  node_cdplot["Cd profile plotting"]
end

subgraph group_outputs["Outputs"]
  node_csv["CSV export"]
  node_landing["6DOF landing dispersion"]
  node_kml["Google Earth KML"]
end

node_user(("OpenRocket user"))

node_user -->|"configures"| node_gui
node_user -->|"starts batch"| node_batchcli
node_gui -->|"configures"| node_extension
node_gui -->|"starts runs"| node_runner
node_batchcli -->|"loads settings"| node_config
node_batchcli -->|"starts runs"| node_runner
node_runner -->|"draws parameters"| node_sampling
node_sampling -->|"indexes dimensions"| node_paramregistry
node_extension -->|"samples profile"| node_disturbance
node_extension -->|"registers listener"| node_recovery
node_extension -->|"registers listener"| node_physics
node_runner -->|"runs simulation"| node_orengine
node_runner -->|"extracts results"| node_extract
node_extract -->|"converts coordinates"| node_landing
node_runner -.->|"records run"| node_record
node_runner -.->|"feeds series"| node_aggregation
node_record -->|"summarizes runs"| node_summary
node_summary -->|"computes metrics"| node_statistics
node_gui -->|"requests recommendation"| node_sigmarec
node_gui -->|"plots profile"| node_cdplot
node_batchcli -->|"exports results"| node_csv
node_batchcli -->|"builds dispersion"| node_landing
node_landing -->|"writes KML"| node_kml
node_summary -.->|"exports summary"| node_csv

click node_gui "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloConfigurator.java"
click node_batchcli "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchCli.java"
click node_config "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/BatchConfigSnapshot.java"
click node_extension "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloExtension.java"
click node_sampling "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/LatinHypercube.java"
click node_paramregistry "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/McParam.java"
click node_disturbance "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/RunWindDisturbanceProfile.java"
click node_recovery "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/RecoveryPerturbationListener.java"
click node_physics "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/PhysicsOverrideListener.java"
click node_windstate "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/WindSnapshot.java"
click node_runner "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchRunner.java"
click node_extract "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/SimulationData.java"
click node_record "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloRunRecord.java"
click node_aggregation "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/DataAggregator.java"
click node_summary "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/BatchSummary.java"
click node_statistics "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/Statistics.java"
click node_sigmarec "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/SigmaRecommender.java"
click node_cdplot "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/CdProfilePlotter.java"
click node_csv "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloCsvExporter.java"
click node_landing "https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/LandingDispersion6DOF.java"

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_gui,node_batchcli,node_config,node_user toneBlue
class node_extension,node_sampling,node_paramregistry,node_disturbance,node_recovery,node_physics,node_windstate,node_runner,node_orengine toneAmber
class node_extract,node_record,node_aggregation,node_summary,node_statistics,node_sigmarec,node_cdplot toneMint
class node_csv,node_landing,node_kml toneRose
```

## Components

### Configuration

- [Plugin configuration](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloConfigurator.java): `src/com/hprc/montecarlo/MonteCarloConfigurator.java`
- [Batch CLI](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchCli.java): `src/com/hprc/montecarlo/MonteCarloBatchCli.java`
- [Batch configuration](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/BatchConfigSnapshot.java): `src/com/hprc/montecarlo/BatchConfigSnapshot.java`

### Simulation

- [Run extension](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloExtension.java): `src/com/hprc/montecarlo/MonteCarloExtension.java`
- [Parameter sampling](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/LatinHypercube.java): `src/com/hprc/montecarlo/LatinHypercube.java`
- [Parameter registry](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/McParam.java): `src/com/hprc/montecarlo/McParam.java`
- [Wind disturbances](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/RunWindDisturbanceProfile.java): `src/com/hprc/montecarlo/RunWindDisturbanceProfile.java`
- [Recovery perturbations](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/RecoveryPerturbationListener.java): `src/com/hprc/montecarlo/RecoveryPerturbationListener.java`
- [Physics overrides](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/PhysicsOverrideListener.java): `src/com/hprc/montecarlo/PhysicsOverrideListener.java`
- [Wind state](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/WindSnapshot.java): `src/com/hprc/montecarlo/WindSnapshot.java`
- [Batch runner](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloBatchRunner.java): `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`
- **OpenRocket simulator**

### Analysis

- [Flight data extraction](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/SimulationData.java): `src/com/hprc/montecarlo/SimulationData.java`
- [Run records](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloRunRecord.java): `src/com/hprc/montecarlo/MonteCarloRunRecord.java`
- [Flight aggregation](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/DataAggregator.java): `src/com/hprc/montecarlo/DataAggregator.java`
- [Batch statistics](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/BatchSummary.java): `src/com/hprc/montecarlo/BatchSummary.java`
- [Statistics](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/Statistics.java): `src/com/hprc/montecarlo/Statistics.java`
- [Sigma recommendation](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/SigmaRecommender.java): `src/com/hprc/montecarlo/SigmaRecommender.java`
- [Cd profile plotting](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/CdProfilePlotter.java): `src/com/hprc/montecarlo/CdProfilePlotter.java`

### Outputs

- [CSV export](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/MonteCarloCsvExporter.java): `src/com/hprc/montecarlo/MonteCarloCsvExporter.java`
- [6DOF landing dispersion](https://github.com/xbl2602/openrocket-monte-carlo/blob/main/src/com/hprc/montecarlo/LandingDispersion6DOF.java): `src/com/hprc/montecarlo/LandingDispersion6DOF.java`
- **Google Earth KML**

### Other components

- **OpenRocket user**

## Connections

- OpenRocket user → Plugin configuration: configures (evidence: `README.md`)
- OpenRocket user → Batch CLI: starts batch (evidence: `README.md`)
- Plugin configuration → Run extension: configures (evidence: `src/com/hprc/montecarlo/MonteCarloConfigurator.java`)
- Plugin configuration → Batch runner: starts runs (evidence: `src/com/hprc/montecarlo/MonteCarloConfigurator.java`)
- Batch CLI → Batch configuration: loads settings (evidence: `src/com/hprc/montecarlo/MonteCarloBatchCli.java`)
- Batch CLI → Batch runner: starts runs (evidence: `src/com/hprc/montecarlo/MonteCarloBatchCli.java`)
- Batch runner → Parameter sampling: draws parameters (evidence: `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`)
- Parameter sampling → Parameter registry: indexes dimensions (evidence: `src/com/hprc/montecarlo/LatinHypercube.java`)
- Run extension → Wind disturbances: samples profile (evidence: `src/com/hprc/montecarlo/MonteCarloExtension.java`)
- Run extension → Recovery perturbations: registers listener (evidence: `src/com/hprc/montecarlo/MonteCarloExtension.java`)
- Run extension → Physics overrides: registers listener (evidence: `src/com/hprc/montecarlo/MonteCarloExtension.java`)
- Batch runner → OpenRocket simulator: runs simulation (evidence: `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`)
- Batch runner → Flight data extraction: extracts results (evidence: `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`)
- Flight data extraction → 6DOF landing dispersion: converts coordinates (evidence: `src/com/hprc/montecarlo/SimulationData.java`)
- Batch runner → Run records: records run (evidence: `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`)
- Batch runner → Flight aggregation: feeds series (evidence: `src/com/hprc/montecarlo/MonteCarloBatchRunner.java`)
- Run records → Batch statistics: summarizes runs (evidence: `src/com/hprc/montecarlo/BatchSummary.java`)
- Batch statistics → Statistics: computes metrics (evidence: `src/com/hprc/montecarlo/BatchSummary.java`)
- Plugin configuration → Sigma recommendation: requests recommendation (evidence: `src/com/hprc/montecarlo/MonteCarloConfigurator.java`)
- Plugin configuration → Cd profile plotting: plots profile (evidence: `src/com/hprc/montecarlo/MonteCarloConfigurator.java`)
- Batch CLI → CSV export: exports results (evidence: `src/com/hprc/montecarlo/MonteCarloBatchCli.java`)
- Batch CLI → 6DOF landing dispersion: builds dispersion (evidence: `src/com/hprc/montecarlo/MonteCarloBatchCli.java`)
- 6DOF landing dispersion → Google Earth KML: writes KML (evidence: `README.md`)
- Batch statistics → CSV export: exports summary (evidence: `src/com/hprc/montecarlo/MonteCarloCsvExporter.java`)
