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). 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) or cross-source. 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.8.0

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.8.0
File Size Uploaded Provenance Actions
combaero_gui-0.8.0.tar.gz 519.0 kB With provenance Details for combaero_gui-0.8.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for combaero-gui 0.8.0
File Interpreter ABI Platform Actions
combaero_gui-0.8.0-py3-none-any.whl Python 3 none any Details for combaero_gui-0.8.0-py3-none-any.whl

Total release size: 803.2 kB

Release files / combaero_gui-0.8.0.tar.gz

Download URL combaero_gui-0.8.0.tar.gz
Size 519.0 kB
Tags Source
SHA-256 checksum
How to use checksums
be61eec0afc9025279c88a203349052884f9f691dd01bdc2dced566c85e5c67e
BLAKE2b-256 checksum
How to use checksums
0614f51600620affc2ea52f642e8752e0a15b91f27d1f2ceeaa2f3491d763b47
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 Oct 31, 2026.

Transparency log

Release files / combaero_gui-0.8.0-py3-none-any.whl

Download URL combaero_gui-0.8.0-py3-none-any.whl
Size 284.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d6cafb22c5cc11314152514322ebd8e87ae41682d46ec9f33b2e5de5604a17f2
BLAKE2b-256 checksum
How to use checksums
00736e0eb92f88d2e390f83b719932ccf35441438ba1c3835005f7cb471ea4ce
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 Oct 31, 2026.

Transparency log

Security for combaero-gui 0.8.0

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.8.0.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 Oct 31, 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