combustion_toolbox

A MATLAB-GUI based open-source tool for solving gaseous combustion problems

https://github.com/combustiontoolbox/combustion_toolbox

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 11 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.3%) to scientific vocabulary

Keywords

app chemical-equilibrium combustion combustion-toolbox detonation dissociation hypersonics ionization linux macos matlab open-source rocket shock-waves thermochemical-code thermochemistry toolbox windows
Last synced: 6 months ago · JSON representation ·

Repository

A MATLAB-GUI based open-source tool for solving gaseous combustion problems

Basic Info
Statistics
  • Stars: 33
  • Watchers: 1
  • Forks: 13
  • Open Issues: 35
  • Releases: 70
Topics
app chemical-equilibrium combustion combustion-toolbox detonation dissociation hypersonics ionization linux macos matlab open-source rocket shock-waves thermochemical-code thermochemistry toolbox windows
Created over 6 years ago · Last pushed 8 months ago
Metadata Files
Readme Contributing License Code of conduct Citation

README.md

Combustion Toolbox

Combustion Toolbox: A MATLAB-GUI based open-source tool for solving gaseous combustion problems

DOI Open in MATLAB Online File Exchange CD Documentation license


     

Main features

The Combustion Toolbox is a MATLAB-based thermochemical framework designed to solve problems involving chemical equilibrium for both gas- and condensed-phase species. The toolbox is composed of several modules, each of which is designed to solve a specific class of problems:

  • CT-EQUIL computes the equilibrium composition of multi-component gas mixtures undergoing thermochemical transformations. The final equilibrium state is determined by a predefined set of chemical species (gaseous—including ions—or condensed phases) and two thermodynamic state functions, such as enthalpy and pressure, e.g., for isobaric combustion processes.
  • CT-SD solves steady-state shock and detonation wave problems for both normal and oblique incidence.
  • CT-ROCKET estimates the theoretical performance of rocket engines under highly idealized conditions.
  • CT-TURBULENCE performs detailed analyses of turbulent flows, including turbulent statistics computations, Helmholtz decomposition, and spectral analyses.

The framework also includes an intuitive graphical user interface (GUI), with a royalty-free standalone version available for Windows, macOS, and Linux.

For installation instructions and usage guidelines, visit the Combustion Toolbox website.

Citing Combustion Toolbox

If you use the Combustion Toolbox in a publication, please cite it using the following references:

  • Cuadra, A., Huete, C., & Vera, M. (2024). Combustion Toolbox: An open-source thermochemical code for gas- and condensed-phase problems involving chemical equilibrium. arXiv:2409.15086.
  • Cuadra, A., Huete, C., & Vera, M. (2025). Combustion Toolbox: A MATLAB-GUI based open-source tool for solving gaseous combustion problems. Version 1.2.0. Zenodo. doi:10.5281/zenodo.5554911.

It can be handy the BibTeX format:

```bibtex @article{cuadra2024a_preprint, title = {{Combustion Toolbox: An open-source thermochemical code for gas- and condensed-phase problems involving chemical equilibrium}}, author = {Cuadra, A. and Huete, C. and Vera, M.}, journal = {{arXiv preprint arXiv:2409.15086}}, year = {2024}, eprint = {2409.15086}, archivePrefix = {arXiv}, primaryClass = {physics.chem-ph}, doi = {10.48550/arXiv.2409.15086} }

@misc{combustiontoolbox, author = "Cuadra, A. and Huete, C. and Vera, M.", title = "{Combustion Toolbox: A MATLAB-GUI based open-source tool for solving gaseous combustion problems}", year = 2025, note = "Version 1.2.0", doi = {https://doi.org/10.5281/zenodo.5554911} } ```

Owner

  • Name: Combustion Toolbox
  • Login: CombustionToolbox
  • Kind: organization
  • Email: combustiontoolboxbot@gmail.com
  • Location: Spain

Combustion Toolbox is a MATLAB-GUI based open-source tool for solving gaseous combustion problems

Citation (CITATION.cff)

# YAML 1.2
---
cff-version: 1.2.0
message: "If you use this software, please cite it using these metadata."
type: misc
license: "GPL-3.0"
title: "Combustion Toolbox: A MATLAB-GUI based open-source tool for solving gaseous combustion problems"
version: 1.2.0
doi: 10.5281/zenodo.5554911
date-released: 2025-03-16
url: "https://combustion-toolbox-website.readthedocs.io"
repository-code: "https://github.com/CombustionToolbox/combustion_toolbox"
abstract:
    "The Combustion Toolbox is a MATLAB-based thermochemical framework designed to solve problems involving chemical equilibrium for both gas- and condensed-phase species. The toolbox is composed of several modules, each of which is designed to solve a specific class of problems:

    - **CT-EQUIL** computes the equilibrium composition of multi-component gas mixtures undergoing thermochemical transformations. The final equilibrium state is determined by a predefined set of chemical species (gaseous—including ions—or condensed phases) and two thermodynamic state functions, such as enthalpy and pressure, e.g., for isobaric combustion processes.
    - **CT-SD** solves steady-state shock and detonation wave problems for both normal and oblique incidence.  
    - **CT-ROCKET** estimates the theoretical performance of rocket engines under highly idealized conditions.
    - **CT-TURBULENCE** performs detailed analyses of turbulent flows, including turbulent statistics computations, Helmholtz decomposition, and spectral analyses.

    The framework also features a **user-friendly graphical user interface (GUI)**.

    > For installation instructions and usage guidelines, visit the [Combustion Toolbox website](https://combustion-toolbox-website.readthedocs.io)."
authors: 
  -
    family-names: "Cuadra"
    given-names: A
    orcid: "https://orcid.org/0000-0001-8280-2426"
  -
    family-names: "Huete"
    given-names: C
    orcid: "https://orcid.org/0000-0002-3227-8520"
  -
    family-names: "Vera"
    given-names: M
    orcid: "https://orcid.org/0000-0001-6878-1788"
cff-version: "1.1.0"
keywords: 
  - thermochemistry
  - "chemical-equilibrium"
  - ionization
  - hypersonics
  - shock waves
  - detonation
  - MATLAB
  - app
  - toolbox
  - "open-source"
  - turbulence

GitHub Events

Total
  • Create event: 25
  • Issues event: 19
  • Release event: 4
  • Watch event: 8
  • Delete event: 22
  • Push event: 178
  • Pull request event: 101
  • Fork event: 4
Last Year
  • Create event: 25
  • Issues event: 19
  • Release event: 4
  • Watch event: 8
  • Delete event: 22
  • Push event: 178
  • Pull request event: 101
  • Fork event: 4

Committers

Last synced: over 1 year ago

All Time
  • Total Commits: 2,791
  • Total Committers: 3
  • Avg Commits per committer: 930.333
  • Development Distribution Score (DDS): 0.125
Past Year
  • Commits: 634
  • Committers: 1
  • Avg Commits per committer: 634.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Alberto Cuadra Lara a****a@i****s 2,442
Alberto Cuadra Lara a****a@g****m 338
Alberto Cuadra Lara a****a@i****m 11
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 94
  • Total pull requests: 111
  • Average time to close issues: 6 months
  • Average time to close pull requests: 34 minutes
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.2
  • Average comments per pull request: 0.0
  • Merged pull requests: 98
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 12
  • Pull requests: 55
  • Average time to close issues: about 7 hours
  • Average time to close pull requests: 18 minutes
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 44
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • AlbertoCuadra (94)
Pull Request Authors
  • AlbertoCuadra (144)
  • Althenor (1)
Top Labels
Issue Labels
enhancement (54) bug (32) app (18) documentation (4) validation (3) help wanted (3)
Pull Request Labels
bug (35) enhancement (32) app (19) documentation (18) validation (6)

Dependencies

.github/workflows/CD.yml actions
  • actions/checkout v2 composite
  • matlab-actions/run-command v1 composite
  • matlab-actions/setup-matlab v1 composite
.github/workflows/CI.yml actions
  • actions/checkout v2 composite
  • matlab-actions/run-command v1 composite
  • matlab-actions/setup-matlab v1 composite
.github/workflows/submodule_update_parent.yml actions
  • actions/checkout v2 composite