Skip to main content

CombAero

C++17 thermodynamics, combustion and flow-network library with Python bindings, for gas turbine combustor and cooling design.

Key Capabilities

  • 🚀 Thermodynamics: NASA-9 polynomials for multi-species gas mixtures (200-6000 K; to 20 000 K for N2, O2, Ar, CO2, CO, H2).
  • 🔥 Combustion: Complete combustion, partial equilibrium (reforming and water-gas shift, no dissociation), and inverse solvers.
  • 💨 Fluid Dynamics: Compressible flow (nozzle, Fanno, Rayleigh), friction correlations, and orifice models.
  • ❄️ Cooling: Correlations for rib enhancement, impingement, film and effusion cooling, and pin fins.
  • 🕸️ Network Solver: Fluid-thermal networks solved with Newton-type methods (MINPACK) on C++ element kernels with analytic Jacobians.
  • 🐍 Python Native: High-level Python bindings for rapid prototyping and data analysis.

Correlations are checked against their source's own data and, separately, against other sources; how is in the Validation Policy.

Quick Start

Install the pre-built wheel (Python 3.12+; we recommend uv):

uv pip install combaero

Calculate adiabatic flame temperature:

import combaero as cb
state = cb.State().set_TPX(300, 101325, "CH4:1, O2:2, N2:7.52")
burned = cb.complete_combustion(state.T, state.X)
print(f"Adiabatic Flame Temperature: {burned.T:.0f} K")

Example scripts, including worked networks from papers, are in python/examples.

C++

Add include/ to your include path and link the library (Building CombAero):

#include <combustion.h>
#include <state.h>
#include <thermo.h>

// Mole fractions in the library's species order: CH4 + 2 (O2 + 3.76 N2).
std::vector<double> X(combaero::num_species(), 0.0);
X[combaero::species_index_from_name("CH4")] = 1.0;
X[combaero::species_index_from_name("O2")] = 2.0;
X[combaero::species_index_from_name("N2")] = 7.52;

combaero::State in;
in.set_T(300.0).set_P(101325.0).set_X(X);
auto burned = combaero::complete_combustion(in);

GUI

For an interactive drag-and-drop network designer, install combaero-gui; its Examples menu loads the worked examples:

uv pip install combaero-gui  # then run: combaero-gui

Documentation

License

MIT License

Metadata

Release files for combaero 0.11.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 0.11.0
File Size Uploaded Provenance Actions
combaero-0.11.0.tar.gz 6.9 MB With provenance Details for combaero-0.11.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for combaero 0.11.0
File Actions
combaero-0.11.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for combaero-0.11.0-cp312-cp312-win_amd64.whl
combaero-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl CPython 3.12 CPython 3.12 Linux musl 1.2+ x86-64 Details for combaero-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl
combaero-0.11.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for combaero-0.11.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
combaero-0.11.0-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for combaero-0.11.0-cp312-cp312-macosx_11_0_arm64.whl
combaero-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl CPython 3.12 CPython 3.12 macOS 10.13+ x86-64 Details for combaero-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl

Total release size: 22.4 MB

Release files / combaero-0.11.0.tar.gz

Download URL combaero-0.11.0.tar.gz
Size 6.9 MB
Tags Source
SHA-256 checksum
How to use checksums
ac3221fde2799871aa527ad078b5553705a4fe764f498d7b77e1bf33b8833ce3
BLAKE2b-256 checksum
How to use checksums
69cc62ede7811d4b4e956ea9b10733a5f365a05d98708535012b48b481fb9bef
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-0.11.0-cp312-cp312-win_amd64.whl

Download URL combaero-0.11.0-cp312-cp312-win_amd64.whl
Size 4.7 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
3cbca4998d8869d1b933d8a5d69d19650022447d50acd3f4072ea4901985c5e9
BLAKE2b-256 checksum
How to use checksums
bbcb00924d9c79467f2e5839bb3532824bc91a36acc266c6d9db0a4097f77928
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-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl

Download URL combaero-0.11.0-cp312-cp312-musllinux_1_2_x86_64.whl
Size 3.7 MB
Tags CPython 3.12 Linux musl 1.2+ x86-64
SHA-256 checksum
How to use checksums
1b430b79bd1d1c7b4bd3000a3bdb57e000577644067d1ef90e499b8e329beec9
BLAKE2b-256 checksum
How to use checksums
4854480ed6ce265be564163a0e0b3c62e457d62795663d24ae19803a981a3986
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-0.11.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL combaero-0.11.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 2.6 MB
Tags CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
16506874b22954df1b11cdfab8c364ae7dedd58a3eb3fa2983d0e2b3201048fc
BLAKE2b-256 checksum
How to use checksums
901c4d1635ffe4ede444402f2a6543396dee32359f477200a6452273fd9983ee
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-0.11.0-cp312-cp312-macosx_11_0_arm64.whl

Download URL combaero-0.11.0-cp312-cp312-macosx_11_0_arm64.whl
Size 2.2 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
7ef44f7c13a127a5983544e936449e8261e32d36253ffecd1338573c8acd74da
BLAKE2b-256 checksum
How to use checksums
946ac3a743eec2501d23972e30699b82d08a9c5f45a584b59c3c2bb935d65232
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-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl

Download URL combaero-0.11.0-cp312-cp312-macosx_10_13_x86_64.whl
Size 2.3 MB
Tags CPython 3.12 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
a141fecc99c8441bd15ada826cd21337ca9f0e87a786a2e788c46c86a36a3aac
BLAKE2b-256 checksum
How to use checksums
23a67108e4bf9ebdff383a149c0bd4d620d77e84c38ff77b19d34d67a0e3f046
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 0.11.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

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for combaero-0.11.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 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