# anthonyz07/rockets_monte_carlo architecture

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

- Interactive diagram: https://gitdiagram.com/anthonyz07/rockets_monte_carlo
- Repository: https://github.com/anthonyz07/rockets_monte_carlo

## Overview

This repository is a set of RocketPy-based rocket landing-dispersion examples, not the RocketPy library itself. The user workflow is to run a scenario simulation, collect landing results, then inspect or visualize the dispersion; the README documents these capabilities, while the notebooks’ implementations were not sampled. The sampled Python module configures the launch environment and builds rocket/motor models, and the sampled analysis script filters landing records by impact velocity. Connections to scenario notebooks and result files are therefore shown only where documented or marked unverified.

Main entry points: [`Scripts/rocket_pams.py`](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/rocket_pams.py) (Rocket Model), [`Scripts/LD Nominal.ipynb`](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Nominal.ipynb) (Nominal Run), [`Scripts/LD Main Only.ipynb`](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Main%20Only.ipynb) (Main-Only Run), [`Scripts/LD Ballistic.ipynb`](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Ballistic.ipynb) (Ballistic Run)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation"]
  node_rocketpy["RocketPy"]
  node_model["Rocket Model<br/>[rocket_pams.py]"]
  node_nominal["Nominal Run<br/>[LD Nominal.ipynb]"]
  node_mainonly["Main-Only Run<br/>[LD Main Only.ipynb]"]
  node_ballistic["Ballistic Run<br/>[LD Ballistic.ipynb]"]
end

subgraph group_analysis["Results Analysis"]
  node_nominaldata["Nominal Results"]
  node_mainonlydata["Main-Only Results"]
  node_ballisticdata["Ballistic Results"]
  node_plotting["Dispersion Plots<br/>[Plotting.ipynb]"]
  node_errorcheck["Impact Filtering<br/>[error_analysis.py]"]
  node_errorrecords["Run Records"]
end

subgraph group_inputs["Simulation Inputs"]
  node_motorfile["Motor Data"]
  node_dragoff["Power-Off Drag<br/>[drag_off.csv]"]
  node_dragon["Power-On Drag<br/>[drag_on.csv]"]
  node_weather["Sounding Service"]
end

node_user(("Engineer"))

node_user -->|"runs scenario"| node_nominal
node_user -->|"runs scenario"| node_mainonly
node_user -->|"runs scenario"| node_ballistic
node_nominal -->|"simulates with"| node_rocketpy
node_mainonly -->|"simulates with"| node_rocketpy
node_ballistic -->|"simulates with"| node_rocketpy
node_model -->|"builds models with"| node_rocketpy
node_model -->|"loads sounding from"| node_weather
node_nominal -.->|"uses model"| node_model
node_mainonly -.->|"uses model"| node_model
node_ballistic -.->|"uses model"| node_model
node_nominal -.->|"records results"| node_nominaldata
node_mainonly -.->|"records results"| node_mainonlydata
node_ballistic -.->|"records results"| node_ballisticdata
node_plotting -.->|"visualizes"| node_nominaldata
node_plotting -.->|"visualizes"| node_mainonlydata
node_plotting -.->|"visualizes"| node_ballisticdata
node_errorcheck -->|"reads records"| node_errorrecords

click node_model "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/rocket_pams.py"
click node_nominal "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Nominal.ipynb"
click node_mainonly "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Main%20Only.ipynb"
click node_ballistic "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Ballistic.ipynb"
click node_nominaldata "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_nominal.csv"
click node_mainonlydata "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_main_only.csv"
click node_ballisticdata "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_ballistic.csv"
click node_plotting "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/Plotting.ipynb"
click node_errorcheck "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/error_analysis.py"
click node_errorrecords "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_main_only.outputs.txt"
click node_motorfile "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/Q-8159_columbia-hybrid.rse"
click node_dragoff "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/drag_off.csv"
click node_dragon "https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/drag_on.csv"

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_rocketpy,node_model,node_nominal,node_mainonly,node_ballistic toneBlue
class node_nominaldata,node_mainonlydata,node_ballisticdata,node_plotting,node_errorcheck,node_errorrecords toneAmber
class node_motorfile,node_dragoff,node_dragon,node_weather toneMint
class node_user toneIndigo
```

## Components

### Simulation

- **RocketPy**
- [Rocket Model](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/rocket_pams.py): `Scripts/rocket_pams.py`
- [Nominal Run](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Nominal.ipynb): `Scripts/LD Nominal.ipynb`
- [Main-Only Run](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Main%20Only.ipynb): `Scripts/LD Main Only.ipynb`
- [Ballistic Run](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/LD%20Ballistic.ipynb): `Scripts/LD Ballistic.ipynb`

### Results Analysis

- [Nominal Results](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_nominal.csv): `Scripts/landing_dispersion_nominal.csv`
- [Main-Only Results](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_main_only.csv): `Scripts/landing_dispersion_main_only.csv`
- [Ballistic Results](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_ballistic.csv): `Scripts/landing_dispersion_ballistic.csv`
- [Dispersion Plots](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/Plotting.ipynb): `Scripts/Plotting.ipynb`
- [Impact Filtering](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/error_analysis.py): `Scripts/error_analysis.py`
- [Run Records](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Scripts/landing_dispersion_main_only.outputs.txt): `Scripts/landing_dispersion_main_only.outputs.txt`

### Simulation Inputs

- [Motor Data](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/Q-8159_columbia-hybrid.rse): `Files/Q-8159_columbia-hybrid.rse`
- [Power-Off Drag](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/drag_off.csv): `Files/drag_off.csv`
- [Power-On Drag](https://github.com/anthonyz07/rockets_monte_carlo/blob/main/Files/drag_on.csv): `Files/drag_on.csv`
- **Sounding Service**

### Other components

- **Engineer**

## Connections

- Engineer → Nominal Run: runs scenario (evidence: `README.md`)
- Engineer → Main-Only Run: runs scenario (evidence: `README.md`)
- Engineer → Ballistic Run: runs scenario (evidence: `README.md`)
- Nominal Run → RocketPy: simulates with (evidence: `README.md`)
- Main-Only Run → RocketPy: simulates with (evidence: `README.md`)
- Ballistic Run → RocketPy: simulates with (evidence: `README.md`)
- Rocket Model → RocketPy: builds models with (evidence: `Scripts/rocket_pams.py`)
- Rocket Model → Sounding Service: loads sounding from (evidence: `Scripts/rocket_pams.py`)
- Nominal Run → Rocket Model: uses model
- Main-Only Run → Rocket Model: uses model
- Ballistic Run → Rocket Model: uses model
- Nominal Run → Nominal Results: records results
- Main-Only Run → Main-Only Results: records results
- Ballistic Run → Ballistic Results: records results
- Dispersion Plots → Nominal Results: visualizes
- Dispersion Plots → Main-Only Results: visualizes
- Dispersion Plots → Ballistic Results: visualizes
- Impact Filtering → Run Records: reads records (evidence: `Scripts/error_analysis.py`)
