# suavecode/suave architecture

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

- Interactive diagram: https://gitdiagram.com/suavecode/suave
- Repository: https://github.com/suavecode/suave

## Overview

SUAVE is a multi-fidelity conceptual aircraft-design environment. Its central workflow is to define a vehicle, evaluate aerodynamic and other analyses, assemble mission behavior, and use optimization to explore design choices; results can then inform conceptual-level conclusions. The repository also includes propulsion/energy models, vehicle geometry, atmospheric and stability analyses, noise, costs, and output utilities. The tree and excerpts support several internal links, but many domain subsystems were not sampled, so their workflow connections are shown as unverified rather than asserted.

Main entry points: [`trunk/SUAVE/Vehicle.py`](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Vehicle.py) (Vehicle), [`trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py`](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py) (Vortex Lattice), [`trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py`](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py) (Supersonic Drag), [`trunk/SUAVE/Analyses/Process.py`](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Process.py) (Analysis Process)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vehicle["Vehicle Model"]
  node_vehicle["Vehicle<br/>[Vehicle.py]"]
  node_wing["Wing Geometry<br/>[Wing.py]"]
  node_mainwing["Main Wing<br/>[Main_Wing.py]"]
  node_wingsegment["Wing Segments<br/>[Segment.py]"]
end

subgraph group_analysis["Analysis"]
  node_aero["Aerodynamics<br/>[Aerodynamics.py]"]
  node_vortex["Vortex Lattice<br/>[Vortex_Lattice.py]"]
  node_supersonic["Supersonic Drag"]
  node_vlm["VLM Method<br/>[VLM.py]"]
  node_dragblend["Drag Blender"]
  node_planform["Segmented Planform"]
  node_process["Analysis Process<br/>[Process.py]"]
  node_mission["Mission Analysis"]
end

subgraph group_energy["Energy Systems"]
  node_energycomponent["Energy Component"]
  node_engine["Combustion Engine"]
  node_esc["Speed Controller"]
  node_network["Propulsion Networks"]
end

subgraph group_design["Design Exploration"]
  node_optimization["Optimization"]
  node_outputs["Results Output"]
end

subgraph group_foundation["Runtime Foundation"]
  node_data["Data Objects<br/>[Data.py]"]
  node_container["Containers<br/>[Container.py]"]
  node_orderedcontainer["Ordered Container"]
  node_ordereddata["Ordered Data<br/>[DataOrdered.py]"]
  node_units["Unit System<br/>[Units.py]"]
  node_quantity["Quantities<br/>[quantity.py]"]
end

node_designer(("Aircraft Designer"))

node_designer -.->|"defines"| node_vehicle
node_vehicle -.->|"evaluated by"| node_aero
node_vehicle -.->|"evaluated by"| node_mission
node_vehicle -.->|"designs with"| node_optimization
node_wing -->|"specializes"| node_mainwing
node_mainwing -->|"uses"| node_wingsegment
node_aero -->|"includes"| node_vortex
node_vortex -->|"calls"| node_vlm
node_vortex -->|"uses"| node_dragblend
node_supersonic -->|"configures"| node_vortex
node_supersonic -->|"builds process"| node_process
node_supersonic -.->|"uses"| node_planform
node_process -->|"uses"| node_orderedcontainer
node_process -->|"uses"| node_ordereddata
node_container -->|"extends"| node_data
node_units -->|"uses"| node_quantity
node_engine -->|"extends"| node_energycomponent
node_esc -->|"extends"| node_energycomponent
node_network -.->|"assembles"| node_energycomponent
node_mission -.->|"uses"| node_network
node_optimization -.->|"evaluates designs"| node_aero
node_optimization -.->|"evaluates designs"| node_mission
node_outputs -->|"converts units"| node_units

click node_vehicle "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Vehicle.py"
click node_wing "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Wing.py"
click node_mainwing "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Main_Wing.py"
click node_wingsegment "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Segment.py"
click node_aero "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Aerodynamics.py"
click node_vortex "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py"
click node_supersonic "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py"
click node_vlm "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Aerodynamics/Common/Fidelity_Zero/Lift/VLM.py"
click node_dragblend "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Aerodynamics/Supersonic_Zero/Drag/Cubic_Spline_Blender.py"
click node_planform "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Geometry/Two_Dimensional/Planform/wing_segmented_planform.py"
click node_process "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Process.py"
click node_mission "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Mission/Sequential_Segments.py"
click node_energycomponent "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Energy_Component.py"
click node_engine "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Converters/Internal_Combustion_Engine.py"
click node_esc "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Distributors/Electronic_Speed_Controller.py"
click node_network "https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Components/Energy/Networks"
click node_optimization "https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Optimization"
click node_data "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Data.py"
click node_container "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Container.py"
click node_orderedcontainer "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/ContainerOrdered.py"
click node_ordereddata "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/DataOrdered.py"
click node_units "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Units.py"
click node_quantity "https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Plugins/pint/quantity.py"
click node_outputs "https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Input_Output/Results"

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_vehicle,node_wing,node_mainwing,node_wingsegment toneBlue
class node_aero,node_vortex,node_supersonic,node_vlm,node_dragblend,node_planform,node_process,node_mission toneAmber
class node_energycomponent,node_engine,node_esc,node_network toneMint
class node_optimization,node_outputs toneRose
class node_data,node_container,node_orderedcontainer,node_ordereddata,node_units,node_quantity,node_designer toneIndigo
```

## Components

### Vehicle Model

- [Vehicle](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Vehicle.py): `trunk/SUAVE/Vehicle.py`
- [Wing Geometry](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Wing.py): `trunk/SUAVE/Components/Wings/Wing.py`
- [Main Wing](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Main_Wing.py): `trunk/SUAVE/Components/Wings/Main_Wing.py`
- [Wing Segments](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Wings/Segment.py): `trunk/SUAVE/Components/Wings/Segment.py`

### Analysis

- [Aerodynamics](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Aerodynamics.py): `trunk/SUAVE/Analyses/Aerodynamics/Aerodynamics.py`
- [Vortex Lattice](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py): `trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py`
- [Supersonic Drag](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py): `trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py`
- [VLM Method](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Aerodynamics/Common/Fidelity_Zero/Lift/VLM.py): `trunk/SUAVE/Methods/Aerodynamics/Common/Fidelity_Zero/Lift/VLM.py`
- [Drag Blender](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Aerodynamics/Supersonic_Zero/Drag/Cubic_Spline_Blender.py): `trunk/SUAVE/Methods/Aerodynamics/Supersonic_Zero/Drag/Cubic_Spline_Blender.py`
- [Segmented Planform](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Methods/Geometry/Two_Dimensional/Planform/wing_segmented_planform.py): `trunk/SUAVE/Methods/Geometry/Two_Dimensional/Planform/wing_segmented_planform.py`
- [Analysis Process](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Process.py): `trunk/SUAVE/Analyses/Process.py`
- [Mission Analysis](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Analyses/Mission/Sequential_Segments.py): `trunk/SUAVE/Analyses/Mission/Sequential_Segments.py`

### Energy Systems

- [Energy Component](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Energy_Component.py): `trunk/SUAVE/Components/Energy/Energy_Component.py`
- [Combustion Engine](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Converters/Internal_Combustion_Engine.py): `trunk/SUAVE/Components/Energy/Converters/Internal_Combustion_Engine.py`
- [Speed Controller](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Components/Energy/Distributors/Electronic_Speed_Controller.py): `trunk/SUAVE/Components/Energy/Distributors/Electronic_Speed_Controller.py`
- [Propulsion Networks](https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Components/Energy/Networks): `trunk/SUAVE/Components/Energy/Networks`

### Design Exploration

- [Optimization](https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Optimization): `trunk/SUAVE/Optimization`
- [Results Output](https://github.com/suavecode/suave/tree/develop/trunk/SUAVE/Input_Output/Results): `trunk/SUAVE/Input_Output/Results`

### Runtime Foundation

- [Data Objects](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Data.py): `trunk/SUAVE/Core/Data.py`
- [Containers](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Container.py): `trunk/SUAVE/Core/Container.py`
- [Ordered Container](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/ContainerOrdered.py): `trunk/SUAVE/Core/ContainerOrdered.py`
- [Ordered Data](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/DataOrdered.py): `trunk/SUAVE/Core/DataOrdered.py`
- [Unit System](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Core/Units.py): `trunk/SUAVE/Core/Units.py`
- [Quantities](https://github.com/suavecode/suave/blob/develop/trunk/SUAVE/Plugins/pint/quantity.py): `trunk/SUAVE/Plugins/pint/quantity.py`

### Other components

- **Aircraft Designer**

## Connections

- Aircraft Designer → Vehicle: defines
- Vehicle → Aerodynamics: evaluated by
- Vehicle → Mission Analysis: evaluated by
- Vehicle → Optimization: designs with
- Wing Geometry → Main Wing: specializes (evidence: `trunk/SUAVE/Components/Wings/Main_Wing.py`)
- Main Wing → Wing Segments: uses (evidence: `trunk/SUAVE/Components/Wings/Main_Wing.py`)
- Aerodynamics → Vortex Lattice: includes (evidence: `trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py`)
- Vortex Lattice → VLM Method: calls (evidence: `trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py`)
- Vortex Lattice → Drag Blender: uses (evidence: `trunk/SUAVE/Analyses/Aerodynamics/Vortex_Lattice.py`)
- Supersonic Drag → Vortex Lattice: configures (evidence: `trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py`)
- Supersonic Drag → Analysis Process: builds process (evidence: `trunk/SUAVE/Analyses/Aerodynamics/Supersonic_OpenVSP_Wave_Drag.py`)
- Supersonic Drag → Segmented Planform: uses
- Analysis Process → Ordered Container: uses (evidence: `trunk/SUAVE/Analyses/Process.py`)
- Analysis Process → Ordered Data: uses (evidence: `trunk/SUAVE/Analyses/Process.py`)
- Containers → Data Objects: extends (evidence: `trunk/SUAVE/Core/Container.py`)
- Unit System → Quantities: uses (evidence: `trunk/SUAVE/Core/Units.py`)
- Combustion Engine → Energy Component: extends (evidence: `trunk/SUAVE/Components/Energy/Converters/Internal_Combustion_Engine.py`)
- Speed Controller → Energy Component: extends (evidence: `trunk/SUAVE/Components/Energy/Distributors/Electronic_Speed_Controller.py`)
- Propulsion Networks → Energy Component: assembles
- Mission Analysis → Propulsion Networks: uses
- Optimization → Aerodynamics: evaluates designs
- Optimization → Mission Analysis: evaluates designs
- Results Output → Unit System: converts units (evidence: `trunk/SUAVE/Input_Output/Results/print_engine_data.py`)
