cantera

Chemical kinetics, thermodynamics, and transport tool suite

https://github.com/cantera/cantera

Science Score: 59.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    23 of 88 committers (26.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.9%) to scientific vocabulary

Keywords from Contributors

code-generation interactive scan loop-optimization interpretability multidimensional-arrays opencl prefix-sum reduction closember
Last synced: 6 months ago · JSON representation

Repository

Chemical kinetics, thermodynamics, and transport tool suite

Basic Info
  • Host: GitHub
  • Owner: Cantera
  • License: other
  • Language: C++
  • Default Branch: main
  • Homepage: https://cantera.org
  • Size: 54.9 MB
Statistics
  • Stars: 703
  • Watchers: 42
  • Forks: 385
  • Open Issues: 86
  • Releases: 19
Created almost 11 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing Funding License Code of conduct Citation Support Authors

README.rst

.. Cantera

|cantera|

|doi| |codecov| |ci| |release|


What is Cantera?
================

Cantera is an open-source collection of object-oriented software tools for
problems involving chemical kinetics, thermodynamics, and transport processes.
Among other things, it can be used to:

* Evaluate thermodynamic and transport properties of mixtures
* Compute chemical equilibrium
* Evaluate species chemical production rates
* Conduct kinetics simulations with large reaction mechanisms
* Simulate one-dimensional flames
* Conduct reaction path analysis
* Create process simulations using networks of stirred reactors
* Model non-ideal fluids

Cantera can be used from Python and Matlab, or in applications written in C++
and Fortran 90. A number of `examples of Cantera's capabilities
`_ are available in the form of
Jupyter notebooks. These examples can be tried interactively, in the cloud by
using the following MyBinder link:

.. image:: https://mybinder.org/badge.svg
    :target: https://mybinder.org/repo/cantera/cantera-jupyter

Installation
============

|pip| |conda-forge|

`Installation instructions for the current release of Cantera
`_ are available from the main `Cantera
documentation site `_.

- The Python module can also be installed using pip on Windows, macOS, and Linux.

- Conda packages containing the Cantera Python and Matlab modules are also available
  for Windows, macOS, and Linux.

- Additional installation packages are provided for Windows, macOS, Ubuntu, Fedora,
  RHEL, Gentoo, and FreeBSD.

- For other platforms, or for users wishing to install a development version of
  Cantera, `compilation instructions `_
  are also available.

Documentation
=============

The `documentation `_ offers a number of starting points:

- `Python tutorial
  `_
- `Application Examples in Python
  `_
- `A guide to Cantera's input file format
  `_
- `User Guide: Tutorials, FAQ, and Task Guides
  `
- `Information about the Cantera community
  `_
- `Affiliated packages
  `_

Code of Conduct
===============

.. image:: https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg
    :alt: conduct
    :target: https://www.contributor-covenant.org/version/2/0/code_of_conduct/

In order to have a more open and welcoming community, Cantera adheres to a
`code of conduct `_ adapted from the `Contributor Covenant
code of conduct `_.

Please adhere to this code of conduct in any interactions you have in the
Cantera community. It is strictly enforced on all official Cantera
repositories, websites, users' group, and other resources. If you encounter
someone violating these terms, please `contact the code of conduct team
`_ (`@speth `_,
`@bryanwweber `_, and `@kyleniemeyer
`_) and we will address it as soon as
possible.

Development Site
================

The current development version is 3.2.0a2. The current stable version is
3.1.0. The `latest Cantera source code `_,
the `issue tracker `_ for bugs and
enhancement requests, `downloads of Cantera releases and binary installers
`_ , and the `Cantera wiki
`_ can all be found on Github.

Users' Group
============

The `Cantera Users' Group `_ is a
message board/mailing list for discussions amongst Cantera users.

Continuous Integration Status
=============================

|ci|

NumFOCUS
========

Cantera is a fiscally-sponsored project of `NumFOCUS `__,
a non-profit dedicated to supporting the open source scientific computing
community. Please consider `making a donation
`__ to support the
development of Cantera through NumFOCUS.

.. image:: https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A
    :target: https://numfocus.org/donate-to-cantera
    :alt: Powered by NumFOCUS

.. |cantera| image:: https://cantera.org/_static/cantera-logo.png
    :target: https://cantera.org
    :alt: cantera logo
    :width: 675px
    :align: middle

.. |ci| image:: https://github.com/Cantera/cantera/workflows/CI/badge.svg
    :target: https://github.com/Cantera/cantera/actions?query=workflow%3ACI+event%3Apush

.. |doi| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.14455267.svg
   :target: https://doi.org/10.5281/zenodo.14455267

.. |codecov| image:: https://img.shields.io/codecov/c/github/Cantera/cantera/main.svg
   :target: https://codecov.io/gh/Cantera/cantera?branch=main

.. |release| image:: https://img.shields.io/github/release/cantera/cantera.svg
   :target: https://github.com/Cantera/cantera/releases
   :alt: GitHub release

.. |pip| image:: https://img.shields.io/pypi/v/cantera
   :target: https://pypi.org/project/Cantera/

.. |conda-forge| image:: https://img.shields.io/conda/v/conda-forge/cantera
   :target: https://anaconda.org/conda-forge/cantera

Owner

  • Name: Cantera
  • Login: Cantera
  • Kind: organization

A suite of object-oriented software tools for problems involving chemical kinetics, thermodynamics, and/or transport processes.

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 12,027
  • Total Committers: 88
  • Avg Commits per committer: 136.67
  • Development Distribution Score (DDS): 0.606
Past Year
  • Commits: 891
  • Committers: 19
  • Avg Commits per committer: 46.895
  • Development Distribution Score (DDS): 0.6
Top Committers
Name Email Commits
Ray Speth s****h@m****u 4,740
Harry Moffat h****a@s****v 2,381
Ingmar Schoegl i****l@l****u 1,887
Bryan W. Weber b****r@g****m 802
Dave Goodwin d****g@c****u 784
Nicholas Malaya n****a@g****m 187
Christopher Neal w****s@g****m 154
ssun30 s****u@n****u 119
bangshiuh b****n@g****m 94
Ingmar Schoegl i****l@l****m 79
Steven DeCaluwe s****e@g****m 70
Sammo Gabay s****o@g****m 65
Gandhali Kogekar g****r@g****m 64
John Hewson j****o@s****v 54
Jongyoon Bae j****e@b****u 45
Victor Brunini v****i@g****m 38
Anthony Walker w****h@o****u 31
bangshiuh c****1@p****u 28
ThorstenZirwes g****7 25
Niclas Garan n****s@w****e 24
Christopher Lueth c****h@g****m 20
Mark E. Fuller m****r@g****e 19
lavdwall L****e@U****e 18
pjsingal p****6@c****u 17
12Chao x****o@n****u 17
band-a-prend t****a@y****u 17
Cory Kinney c****y@u****u 15
g3bk47 g****7@g****m 15
David AKINPELU a****e@y****m 14
Richard West r****t@n****u 13
and 58 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 215
  • Total pull requests: 580
  • Average time to close issues: 7 months
  • Average time to close pull requests: about 1 month
  • Total issue authors: 87
  • Total pull request authors: 40
  • Average comments per issue: 2.85
  • Average comments per pull request: 3.2
  • Merged pull requests: 485
  • Bot issues: 0
  • Bot pull requests: 12
Past Year
  • Issues: 51
  • Pull requests: 190
  • Average time to close issues: 20 days
  • Average time to close pull requests: 10 days
  • Issue authors: 35
  • Pull request authors: 20
  • Average comments per issue: 1.22
  • Average comments per pull request: 1.95
  • Merged pull requests: 142
  • Bot issues: 0
  • Bot pull requests: 10
Top Authors
Issue Authors
  • speth (50)
  • ischoegl (40)
  • GoogleCodeExporter (6)
  • bryanwweber (6)
  • wandadars (6)
  • corykinney (5)
  • mefuller (4)
  • yurivict (4)
  • Naikless (3)
  • BangShiuh (3)
  • band-a-prend (3)
  • CharlelieLrt (2)
  • AndreySchadel (2)
  • g3bk47 (2)
  • dylanrubini (2)
Pull Request Authors
  • speth (210)
  • ischoegl (175)
  • bryanwweber (49)
  • ssun30 (17)
  • wandadars (16)
  • g3bk47 (15)
  • BangShiuh (13)
  • dependabot[bot] (12)
  • corykinney (8)
  • gkogekar (5)
  • mefuller (5)
  • burkenyo (5)
  • etsandall (4)
  • anthony-walker (3)
  • band-a-prend (3)
Top Labels
Issue Labels
bug (58) compiling (22) Python (20) Thermo (18) Input (18) documentation (16) Matlab (12) 1D Flames (12) Kinetics (9) Reactors (8) regression (7) CI (6) migrated (6) tests (6) Equilibrium (5) Examples (5) enhancement (5) macOS (5) clib (5) Transport (5) Windows (4) question (3) help wanted (2) discussion (2) .NET (2) High Priority (1) Species (1) Linux (1) dependencies (1) Low Priority (1)
Pull Request Labels
documentation (56) Python (53) clib (48) compiling (43) enhancement (43) 1D Flames (40) Reactors (35) CI (34) Matlab (30) Input (26) Thermo (26) Kinetics (24) Examples (14) .NET (12) dependencies (12) github_actions (10) Transport (7) tests (7) Windows (5) macOS (3) Species (3) Performance (3) website (3) Linux (2) bug (2) discussion (2) help wanted (2) Equilibrium (1)

Packages

  • Total packages: 6
  • Total downloads:
    • pypi 31,258 last-month
  • Total dependent packages: 8
    (may contain duplicates)
  • Total dependent repositories: 43
    (may contain duplicates)
  • Total versions: 62
  • Total maintainers: 3
pypi.org: cantera

Cantera is an open-source suite of tools for problems involving chemical kinetics, thermodynamics, and transport processes.

  • Homepage: https://cantera.org
  • Documentation: https://cantera.org/stable/reference
  • License: Copyright (c) 2001-2009, California Institute of Technology All rights reserved. Copyright (c) 2009 Sandia Corporation. Under the terms of Contract AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software. Copyright (c) 2011-2024, Cantera Developers. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - Neither the name of the California Institute of Technology, Sandia Corporation nor the names of other contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • Latest release: 3.1.0
    published about 1 year ago
  • Versions: 12
  • Dependent Packages: 6
  • Dependent Repositories: 19
  • Downloads: 31,258 Last month
Rankings
Dependent packages count: 1.4%
Stargazers count: 2.8%
Average: 2.8%
Forks count: 2.9%
Dependent repos count: 3.3%
Downloads: 3.6%
Maintainers (3)
Funding
  • https://numfocus.org/donate-to-cantera
Last synced: 6 months ago
proxy.golang.org: github.com/cantera/cantera
  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.5%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
proxy.golang.org: github.com/Cantera/cantera
  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.5%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
conda-forge.org: libcantera

Cantera is an open-source suite of tools for problems involving chemical kinetics, thermodynamics, and transport processes

  • Homepage: https://cantera.org
  • License: BSD-3-Clause
  • Latest release: 2.6.0
    published over 3 years ago
  • Versions: 4
  • Dependent Packages: 2
  • Dependent Repositories: 1
Rankings
Forks count: 10.0%
Average: 18.1%
Stargazers count: 18.3%
Dependent packages count: 19.6%
Dependent repos count: 24.4%
Last synced: 6 months ago
conda-forge.org: cantera

Cantera is an open-source suite of tools for problems involving chemical kinetics, thermodynamics, and transport processes

  • Homepage: https://cantera.org
  • License: BSD-3-Clause
  • Latest release: 2.6.0
    published over 3 years ago
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 22
Rankings
Dependent repos count: 7.7%
Forks count: 10.0%
Stargazers count: 18.3%
Average: 21.9%
Dependent packages count: 51.6%
Last synced: 6 months ago
conda-forge.org: libcantera-devel

Cantera is an open-source suite of tools for problems involving chemical kinetics, thermodynamics, and transport processes

  • Homepage: https://cantera.org
  • License: BSD-3-Clause
  • Latest release: 2.6.0
    published over 3 years ago
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Forks count: 10.0%
Stargazers count: 18.3%
Dependent repos count: 24.4%
Average: 26.1%
Dependent packages count: 51.6%
Last synced: 6 months ago

Dependencies

.github/workflows/main.yml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/download-artifact v3 composite
  • actions/setup-dotnet v2 composite
  • actions/setup-python v4 composite
  • actions/setup-python v2 composite
  • actions/upload-artifact v3 composite
  • actions/upload-artifact v2 composite
  • codecov/codecov-action v3 composite
  • conda-incubator/setup-miniconda v2 composite
  • egor-tensin/setup-mingw v2 composite
  • shimataro/ssh-key-action v2 composite
interfaces/dotnet/Cantera/Cantera.csproj nuget
  • Nullable 1.3.0
  • System.Memory 4.5.4
interfaces/dotnet/Cantera.Tests/Cantera.Tests.csproj nuget
  • Microsoft.NET.Test.Sdk 17.3.0
  • coverlet.collector 3.1.2
  • xunit 2.4.2
  • xunit.runner.visualstudio 2.4.5
.github/workflows/linters.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • tj-actions/changed-files v37 composite
.github/workflows/packaging.yml actions
.github/workflows/post-merge-tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
interfaces/dotnet/examples/Application/Application.csproj nuget
interfaces/dotnet/examples/SoundSpeed/SoundSpeed.csproj nuget
interfaces/cython/pyproject.toml pypi
interfaces/cython/setup.py pypi
interfaces/python_minimal/pyproject.toml pypi
interfaces/python_minimal/setup.py pypi
interfaces/python_sdist/pyproject.toml pypi
interfaces/python_sdist/setup.py pypi