# prashantroot/aeroopt-x architecture

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

- Interactive diagram: https://gitdiagram.com/prashantroot/aeroopt-x
- Repository: https://github.com/prashantroot/aeroopt-x

## Overview

AeroOpt-X is a browser-based aerospace analysis workspace backed by Flask and Python engineering modules. Its main workflow is to configure vehicle and flight conditions in the dashboard, submit analysis requests through the API client, and inspect calculated engineering results in interactive charts. The backend also supports optimization, trajectory simulation, and parametric sweeps; geometry utilities provide flow visualization and STL export. The README documents broader dashboard capabilities and pages. Some backend calls and frontend rendering details are only partially excerpted, so uncertain links are omitted.

Main entry points: [`app/main.py`](https://github.com/prashantroot/aeroopt-x/blob/main/app/main.py) (Flask application), [`app/static/js/api.js`](https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/api.js) (API client), [`src/aeroopt/geometry/nose_cone.py`](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/nose_cone.py) (Nose profiles), [`app/static/js/app.js`](https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/app.js) (Dashboard controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard and guidance"]
  node_dashboard["Dashboard controller<br/>[app.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_charts["Interactive charts<br/>[charts.js]"]
  node_documentation["Documentation page<br/>[documentation.html]"]
  node_help["Help page<br/>[help.html]"]
end

subgraph group_service["Request orchestration"]
  node_flask["Flask application<br/>[main.py]"]
end

subgraph group_engineering["Engineering analysis"]
  node_drag["Drag solver<br/>[drag_solver.py]"]
  node_optimizer["Geometry optimizer<br/>[objective.py]"]
  node_aerothermal["Aerothermal analysis<br/>[aerothermal.py]"]
  node_trajectory["Trajectory simulation<br/>[trajectory.py]"]
end

subgraph group_geometry["Geometry and visualization"]
  node_nose["Nose profiles<br/>[nose_cone.py]"]
  node_flow["Flow visualization<br/>[flow_visualizer.py]"]
  node_stl["STL export<br/>[stl_exporter.py]"]
  node_drone_arm["Drone arm geometry<br/>[drone_arm.py]"]
  node_stream_flow["Stream flow visualizer<br/>[stream_flow.py]"]
end

node_engineer(("Engineer"))

node_engineer -->|"configures"| node_dashboard
node_dashboard -->|"submits requests"| node_api_client
node_api_client -->|"sends HTTP requests"| node_flask
node_flask -->|"generates profiles"| node_nose
node_flask -->|"evaluates drag"| node_drag
node_flask -->|"requests optimization"| node_optimizer
node_optimizer -->|"evaluates objective"| node_drag
node_flask -->|"analyzes thermal conditions"| node_aerothermal
node_flask -->|"runs simulation"| node_trajectory
node_api_client -.->|"provides result data"| node_charts
node_nose -.->|"supplies profile coordinates"| node_flow
node_nose -.->|"supplies profile coordinates"| node_stl
node_engineer -->|"consults"| node_documentation
node_engineer -->|"consults"| node_help

click node_dashboard "https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/app.js"
click node_api_client "https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/api.js"
click node_charts "https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/charts.js"
click node_documentation "https://github.com/prashantroot/aeroopt-x/blob/main/app/templates/documentation/documentation.html"
click node_help "https://github.com/prashantroot/aeroopt-x/blob/main/app/templates/help/help.html"
click node_flask "https://github.com/prashantroot/aeroopt-x/blob/main/app/main.py"
click node_nose "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/nose_cone.py"
click node_drag "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/drag_solver.py"
click node_optimizer "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/optimizer/objective.py"
click node_aerothermal "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/aerothermal.py"
click node_trajectory "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/trajectory.py"
click node_flow "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/flow_visualizer.py"
click node_stl "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/stl_exporter.py"
click node_drone_arm "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/drone_arm.py"
click node_stream_flow "https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/visualizer/stream_flow.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_dashboard,node_api_client,node_charts,node_documentation,node_help toneBlue
class node_flask toneAmber
class node_drag,node_optimizer,node_aerothermal,node_trajectory toneMint
class node_nose,node_flow,node_stl,node_drone_arm,node_stream_flow toneRose
class node_engineer toneIndigo
```

## Components

### Dashboard and guidance

- [Dashboard controller](https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/app.js): `app/static/js/app.js`
- [API client](https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/api.js): `app/static/js/api.js`
- [Interactive charts](https://github.com/prashantroot/aeroopt-x/blob/main/app/static/js/charts.js): `app/static/js/charts.js`
- [Documentation page](https://github.com/prashantroot/aeroopt-x/blob/main/app/templates/documentation/documentation.html): `app/templates/documentation/documentation.html`
- [Help page](https://github.com/prashantroot/aeroopt-x/blob/main/app/templates/help/help.html): `app/templates/help/help.html`

### Request orchestration

- [Flask application](https://github.com/prashantroot/aeroopt-x/blob/main/app/main.py): `app/main.py`

### Engineering analysis

- [Drag solver](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/drag_solver.py): `src/aeroopt/physics/drag_solver.py`
- [Geometry optimizer](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/optimizer/objective.py): `src/aeroopt/optimizer/objective.py`
- [Aerothermal analysis](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/aerothermal.py): `src/aeroopt/physics/aerothermal.py`
- [Trajectory simulation](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/physics/trajectory.py): `src/aeroopt/physics/trajectory.py`

### Geometry and visualization

- [Nose profiles](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/nose_cone.py): `src/aeroopt/geometry/nose_cone.py`
- [Flow visualization](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/flow_visualizer.py): `src/aeroopt/geometry/flow_visualizer.py`
- [STL export](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/stl_exporter.py): `src/aeroopt/geometry/stl_exporter.py`
- [Drone arm geometry](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/geometry/drone_arm.py): `src/aeroopt/geometry/drone_arm.py`
- [Stream flow visualizer](https://github.com/prashantroot/aeroopt-x/blob/main/src/aeroopt/visualizer/stream_flow.py): `src/aeroopt/visualizer/stream_flow.py`

### Other components

- **Engineer**

## Connections

- Engineer → Dashboard controller: configures (evidence: `README.md`)
- Dashboard controller → API client: submits requests (evidence: `app/static/js/app.js`)
- API client → Flask application: sends HTTP requests (evidence: `app/static/js/api.js`)
- Flask application → Nose profiles: generates profiles (evidence: `README.md`)
- Flask application → Drag solver: evaluates drag (evidence: `README.md`)
- Flask application → Geometry optimizer: requests optimization (evidence: `README.md`)
- Geometry optimizer → Drag solver: evaluates objective (evidence: `src/aeroopt/optimizer/objective.py`)
- Flask application → Aerothermal analysis: analyzes thermal conditions (evidence: `app/main.py`)
- Flask application → Trajectory simulation: runs simulation (evidence: `app/main.py`)
- API client → Interactive charts: provides result data
- Nose profiles → Flow visualization: supplies profile coordinates
- Nose profiles → STL export: supplies profile coordinates
- Engineer → Documentation page: consults (evidence: `README.md`)
- Engineer → Help page: consults (evidence: `README.md`)
