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

Built distributions (wheels)

Table of built distributions (wheels) for combaero 0.11.1
File Actions
combaero-0.11.1-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for combaero-0.11.1-cp312-cp312-win_amd64.whl
combaero-0.11.1-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.1-cp312-cp312-musllinux_1_2_x86_64.whl
combaero-0.11.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for combaero-0.11.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
combaero-0.11.1-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for combaero-0.11.1-cp312-cp312-macosx_11_0_arm64.whl
combaero-0.11.1-cp312-cp312-macosx_10_13_x86_64.whl CPython 3.12 CPython 3.12 macOS 10.13+ x86-64 Details for combaero-0.11.1-cp312-cp312-macosx_10_13_x86_64.whl

Total release size: 22.4 MB

Release files / combaero-0.11.1.tar.gz

Download URL combaero-0.11.1.tar.gz
Size 6.9 MB
Tags Source
SHA-256 checksum
How to use checksums
2c6394579efc73fc4b5e626cd5eb6cebffd507241c85345ebd866f9f89acc72d
BLAKE2b-256 checksum
How to use checksums
b493a84d5d2a90ed657c95dfa55c3e64449521fccf86ede431658ec224340703
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.1-cp312-cp312-win_amd64.whl

Download URL combaero-0.11.1-cp312-cp312-win_amd64.whl
Size 4.7 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
f896e5e0811ba9b79be3bbc554af24d566045492ec8804f46b8920db6de87852
BLAKE2b-256 checksum
How to use checksums
021a796283ca3384bfe0b7d36fd5d98f384b4c9a4741440815c925f8cf429c73
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.1-cp312-cp312-musllinux_1_2_x86_64.whl

Download URL combaero-0.11.1-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
5a2c81de5ce4d95b6ac44bc99107b1921832ee2955eeb92b1a5f8874e9fdf22e
BLAKE2b-256 checksum
How to use checksums
e5e4b854fd0e4481dccb3ae27da179b48e984226d2eccbf3ebc4efee47372c1c
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.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL combaero-0.11.1-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
afa0f6cbe16fe52929cba739bb57bb4dea2541ebe6945e66c4ef3a42711d4411
BLAKE2b-256 checksum
How to use checksums
99a9986ec35b38e12dbc3f31ae0b4329dbb17578f8ea0b4f1f3b577235075bd2
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.1-cp312-cp312-macosx_11_0_arm64.whl

Download URL combaero-0.11.1-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
d7cb06721f5c7ba1823058c81d8132337cda093a56487ff954f438a85533c90b
BLAKE2b-256 checksum
How to use checksums
18ce3ddb4e7a7ec182ef7e611b9ed10a3d747056a8e6f281fde2f6f8bc24a221
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.1-cp312-cp312-macosx_10_13_x86_64.whl

Download URL combaero-0.11.1-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
94a94651db5ee3be99dab19defdaebcb709f62bda19b2d7a663157d04cfece6e
BLAKE2b-256 checksum
How to use checksums
6b9b60d852d59637c0961d049c0882127cff0e1b2adb99ef85e81d6180796d94
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.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

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

Select from 6 files

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