# javilendi/vlmpy architecture

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

- Interactive diagram: https://gitdiagram.com/javilendi/vlmpy
- Repository: https://github.com/javilendi/vlmpy

## Overview

VLMPy is a wing-aerodynamics toolkit with a browser-based interface hosted in a desktop shell. Users define airfoils, wing surfaces, and flight conditions, then run aerodynamic analyses and inspect coefficients and visualizations; they can also save configurations/results and export plane geometry as STL. The graph preserves the documented 2D panel-method and NACA capabilities. Edges are limited to relationships shown in the excerpts, source index, or README; several UI and supporting modules are represented from the tree without asserting unsampled call paths.

Main entry points: [`src/vlm/app.py`](https://github.com/javilendi/vlmpy/blob/main/src/vlm/app.py) (Web application), [`src/vlm/lib/vlm.py`](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/vlm.py) (VLM solver), [`src/vlm/lib/geometry.py`](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/geometry.py) (Wing geometry), [`src/vlm/webui.py`](https://github.com/javilendi/vlmpy/blob/main/src/vlm/webui.py) (Desktop shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Application interface"]
  node_desktop["Desktop shell<br/>[webui.py]"]
  node_webapp["Web application<br/>[app.py]"]
  node_frontend["Web interface"]
  node_browserlogic["Interface behavior"]
end

subgraph group_modeling["Geometry modeling"]
  node_airfoils["NACA profiles<br/>[naca.py]"]
  node_winggeometry["Wing geometry<br/>[geometry.py]"]
  node_geometryview["Geometry serialization"]
end

subgraph group_analysis["Aerodynamic analysis"]
  node_vlmsolver["VLM solver<br/>[vlm.py]"]
  node_panelmethod["2D panel method<br/>[panel2d.py]"]
  node_atmosphere["Atmosphere model<br/>[isa.py]"]
end

subgraph group_persistence["Data and export"]
  node_configstore[("Configuration manager<br/>[config_manager.py]")]
  node_resultfiles["Analysis results<br/>[vlm.py]"]
  node_stlexport["STL export<br/>[wing_to_stl.py]"]
  node_stlintegration["STL integration example"]
  node_saveddata[("Saved configurations")]
end

node_engineer(("Engineer"))

node_engineer -->|"opens"| node_desktop
node_desktop -->|"hosts"| node_webapp
node_engineer -->|"defines case"| node_frontend
node_frontend -.->|"uses interface code"| node_browserlogic
node_browserlogic -->|"requests API"| node_webapp
node_webapp -->|"uses profiles"| node_airfoils
node_webapp -->|"uses geometry"| node_winggeometry
node_webapp -->|"serializes geometry"| node_geometryview
node_webapp -->|"runs analysis"| node_vlmsolver
node_webapp -->|"runs analysis"| node_panelmethod
node_webapp -->|"manages configurations"| node_configstore
node_webapp -->|"exports geometry"| node_stlexport
node_winggeometry -->|"generates profiles"| node_airfoils
node_vlmsolver -->|"uses geometry"| node_winggeometry
node_configstore -->|"stores configurations"| node_saveddata
node_vlmsolver -->|"saves and loads"| node_resultfiles
node_stlintegration -->|"calls exporter"| node_stlexport

click node_desktop "https://github.com/javilendi/vlmpy/blob/main/src/vlm/webui.py"
click node_webapp "https://github.com/javilendi/vlmpy/blob/main/src/vlm/app.py"
click node_frontend "https://github.com/javilendi/vlmpy/tree/main/src/vlm/templates"
click node_browserlogic "https://github.com/javilendi/vlmpy/tree/main/src/vlm/static/js"
click node_airfoils "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/naca.py"
click node_winggeometry "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/geometry.py"
click node_geometryview "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/geometry_serialization.py"
click node_vlmsolver "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/vlm.py"
click node_panelmethod "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/panel2d.py"
click node_atmosphere "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/isa.py"
click node_configstore "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/config_manager.py"
click node_resultfiles "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/vlm.py"
click node_stlexport "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/wing_to_stl.py"
click node_stlintegration "https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/ejemplo_integracion_stl.py"
click node_saveddata "https://github.com/javilendi/vlmpy/tree/main/src/vlm/data"

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_desktop,node_webapp,node_frontend,node_browserlogic toneBlue
class node_airfoils,node_winggeometry,node_geometryview toneAmber
class node_vlmsolver,node_panelmethod,node_atmosphere toneMint
class node_configstore,node_resultfiles,node_stlexport,node_stlintegration,node_saveddata toneRose
class node_engineer toneIndigo
```

## Components

### Application interface

- [Desktop shell](https://github.com/javilendi/vlmpy/blob/main/src/vlm/webui.py): `src/vlm/webui.py`
- [Web application](https://github.com/javilendi/vlmpy/blob/main/src/vlm/app.py): `src/vlm/app.py`
- [Web interface](https://github.com/javilendi/vlmpy/tree/main/src/vlm/templates): `src/vlm/templates`
- [Interface behavior](https://github.com/javilendi/vlmpy/tree/main/src/vlm/static/js): `src/vlm/static/js`

### Geometry modeling

- [NACA profiles](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/naca.py): `src/vlm/lib/naca.py`
- [Wing geometry](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/geometry.py): `src/vlm/lib/geometry.py`
- [Geometry serialization](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/geometry_serialization.py): `src/vlm/lib/geometry_serialization.py`

### Aerodynamic analysis

- [VLM solver](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/vlm.py): `src/vlm/lib/vlm.py`
- [2D panel method](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/panel2d.py): `src/vlm/lib/panel2d.py`
- [Atmosphere model](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/isa.py): `src/vlm/lib/isa.py`

### Data and export

- [Configuration manager](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/config_manager.py): `src/vlm/lib/config_manager.py`
- [Analysis results](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/vlm.py): `src/vlm/lib/vlm.py`
- [STL export](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/wing_to_stl.py): `src/vlm/lib/wing_to_stl.py`
- [STL integration example](https://github.com/javilendi/vlmpy/blob/main/src/vlm/lib/ejemplo_integracion_stl.py): `src/vlm/lib/ejemplo_integracion_stl.py`
- [Saved configurations](https://github.com/javilendi/vlmpy/tree/main/src/vlm/data): `src/vlm/data`

### Other components

- **Engineer**

## Connections

- Engineer → Desktop shell: opens (evidence: `README.md`)
- Desktop shell → Web application: hosts (evidence: `src/vlm/webui.py`)
- Engineer → Web interface: defines case (evidence: `README.md`)
- Web interface → Interface behavior: uses interface code
- Interface behavior → Web application: requests API (evidence: `src/vlm/static/js/config-manager.js`)
- Web application → NACA profiles: uses profiles (evidence: `src/vlm/app.py`)
- Web application → Wing geometry: uses geometry (evidence: `src/vlm/app.py`)
- Web application → Geometry serialization: serializes geometry (evidence: `src/vlm/app.py`)
- Web application → VLM solver: runs analysis (evidence: `src/vlm/app.py`)
- Web application → 2D panel method: runs analysis (evidence: `src/vlm/app.py`)
- Web application → Configuration manager: manages configurations (evidence: `src/vlm/app.py`)
- Web application → STL export: exports geometry (evidence: `src/vlm/app.py`)
- Wing geometry → NACA profiles: generates profiles (evidence: `src/vlm/lib/geometry.py`)
- VLM solver → Wing geometry: uses geometry (evidence: `src/vlm/lib/vlm.py`)
- Configuration manager → Saved configurations: stores configurations (evidence: `src/vlm/lib/config_manager.py`)
- VLM solver → Analysis results: saves and loads (evidence: `src/vlm/lib/vlm.py`)
- STL integration example → STL export: calls exporter (evidence: `src/vlm/lib/ejemplo_integracion_stl.py`)
