Skip to main content

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.

  • 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)

Source distribution for combaero-gui 0.11.1
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)

Table of built distributions (wheels) for combaero-gui 0.11.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page