CombAero Network Designer GUI
Interactive design and diagnostic environment for fluid-thermal networks.
The CombAero GUI allows for rapid construction of complex aerospace networks using a drag-and-drop interface powered by React Flow and a high-performance C++ backend.
Quick Start
1. Install
Create a virtual environment (Python 3.12+; we recommend uv) and install:
uv pip install combaero-gui
2. Launch
combaero-gui
Open http://127.0.0.1:8000 in your browser.
Key Workflows
- Build: Drag nodes (Plenums, Boundaries) and elements (Orifices, Channels) from the sidebar.
- Connect: Click and drag from node handles to element ports.
- Solve: Click the Solve button in the header. Successful solves turn node borders green.
- Inspect: Click on any node or element to view real-time diagnostics in the Inspector sidebar.
- Export: Export CSV writes the results, one row per entity with units in the headers, and the inputs that defined the case.
gui.backend.results.load_results(path)reads it back into a one-row-per-case table (format:docs/GUI_TECHNICAL.md, "CSV Export"). - Examples: The Examples menu in the header opens worked examples rebuilt from papers (the Florschuetz 1981 jet array, an ISO 5167-2 orifice metering run, the Hylton 1983 C3X cooled vane). Each opens with a short description: the source, what is reproduced, where to look, and whether the comparison is fidelity (the source's own data), cross-source, or tuned (tuners fitted to the source's data, the untuned error reported beside it). The matching scripts, with the full comparison, are in
python/examples/papers/of the source repository.
Agent Reference (UI Automation Map)
For agents with screen control (multimodal LLMs), the following selectors and IDs are provided to assist in navigation:
| UI Component | Selector / ID | Description |
|---|---|---|
| Solve Button | #solve-btn |
Triggers the network solve. |
| Inspector Sidebar | .inspector-panel |
Properties for selected node/element. |
| Network Canvas | #rf-canvas |
The main React Flow workspace. |
| Node (General) | .react-flow__node |
Any node on the canvas. |
| Solved Indicator | .solved-status-ok |
Appears on nodes after a successful solve. |
| Error Console | #error-output |
Displays solver convergence failures. |
Related
- combaero — the C++ physics core and Python API powering this GUI.
- Source & docs — monorepo with full API reference and technical documentation.
Metadata
Release files for combaero-gui 0.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| combaero_gui-0.11.1.tar.gz | 577.2 kB | With provenance | Details for combaero_gui-0.11.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| combaero_gui-0.11.1-py3-none-any.whl | Python 3 | none | any | Details for combaero_gui-0.11.1-py3-none-any.whl |
Total release size: 894.3 kB
Release files / combaero_gui-0.11.1.tar.gz
| Download URL | combaero_gui-0.11.1.tar.gz |
|---|---|
| Size | 577.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e162998039fe806ce11de01a7c7b16acef6ae6946b80e87d47f52519b426f415
|
|
BLAKE2b-256 checksum How to use checksums |
dcb1c070d4030df9f32c7fbae7ee8ec8cd2d143e991bbc467dc8f51f9334b6f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logRelease files / combaero_gui-0.11.1-py3-none-any.whl
| Download URL | combaero_gui-0.11.1-py3-none-any.whl |
|---|---|
| Size | 317.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
79cf689b56a40d46fe3a862b88b3d3388abed642315ebdd2b4c5522b85dea4f1
|
|
BLAKE2b-256 checksum How to use checksums |
cd3edd0f47b7722e439d18d8b156e8bf7b33b5034c4cb3a68b7e984ec4d1447c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logSecurity for combaero-gui 0.11.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for combaero_gui-0.11.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.