Metadata-Version: 2.4
Name: cantera
Version: 3.2.0b1
Summary: Cantera is an open-source suite of tools for problems involving chemical kinetics, thermodynamics, and transport processes.
Keywords: chemistry physics
Author-Email: Cantera Developers <developers@cantera.org>
License-Expression: BSD-3-Clause
License-File: License.txt
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: C
Classifier: Programming Language :: C++
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Fortran
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Free Threading :: 1 - Unstable
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Typing :: Typed
Project-URL: Homepage, https://cantera.org
Project-URL: Documentation, https://cantera.org/stable/reference
Project-URL: Funding, https://numfocus.org/donate-to-cantera
Project-URL: Source, https://github.com/Cantera/cantera
Project-URL: Tracker, https://github.com/Cantera/cantera/issues
Requires-Python: <3.15,>=3.10
Requires-Dist: numpy<3,>=1.21.0
Requires-Dist: ruamel.yaml<1,>=0.17.21
Provides-Extra: pandas
Requires-Dist: pandas; extra == "pandas"
Provides-Extra: units
Requires-Dist: pint; extra == "units"
Provides-Extra: graphviz
Requires-Dist: graphviz; extra == "graphviz"
Description-Content-Type: text/x-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 a number of different programming languages. Numerous examples
are available on the Cantera website:

* `Python <https://cantera.org/stable/examples/python/index.html>`_
* `Matlab <https://cantera.org/stable/examples/matlab_experimental/index.html>`_
* `C++ <https://cantera.org/stable/examples/cxx/index.html>`_
* `C <https://cantera.org/stable/examples/clib/index.html>`_
* `Fortran 90 <https://cantera.org/stable/examples/fortran/index.html>`_

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

|pip| |conda-forge|

`Installation instructions for the current release of Cantera
<https://cantera.org/stable/install/index.html>`_ are available from the main `Cantera
documentation site <https://cantera.org>`_.

- 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 Ubuntu, Gentoo, and FreeBSD.

- For other platforms, or for users wishing to install a development version of
  Cantera, `compilation instructions <https://cantera.org/stable/develop/index.html>`_
  are also available.

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

The `documentation <https://cantera.org>`_ offers a number of starting points:

- `Python tutorial
  <https://cantera.org/stable/userguide/python-tutorial.html>`_
- `Application Examples in Python
  <https://cantera.org/stable/examples/python/index.html>`_
- `A guide to Cantera's input file format
  <https://cantera.org/stable/userguide/input-tutorial.html>`_
- `User Guide: Tutorials, FAQ, and Task Guides
  <https://cantera.org/stable/userguide/index.html>`
- `Information about the Cantera community
  <https://cantera.org/community.html>`_
- `Affiliated packages
  <https://cantera.org/affiliated.html>`_

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 <CODE_OF_CONDUCT.md>`_ adapted from the `Contributor Covenant
code of conduct <https://contributor-covenant.org/>`_.

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
<mailto:conduct@cantera.org>`_ (`@speth <https://github.com/speth>`_,
`@bryanwweber <https://github.com/bryanwweber>`_, and `@kyleniemeyer
<https://github.com/kyleniemeyer>`_) and we will address it as soon as
possible.

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

The current development version is 3.2.0b1. The current stable version is
3.1.0. The `latest Cantera source code <https://github.com/Cantera/cantera>`_,
the `issue tracker <https://github.com/Cantera/cantera/issues>`_ for bugs and
enhancement requests, `downloads of Cantera releases and binary installers
<https://github.com/Cantera/cantera/releases>`_ , and the `Cantera wiki
<https://github.com/Cantera/cantera/wiki>`_ can all be found on Github.

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

The `Cantera Users' Group <https://groups.google.com/group/cantera-users>`_ is a
message board/mailing list for discussions amongst Cantera users.

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

|ci|

NumFOCUS
========

Cantera is a fiscally-sponsored project of `NumFOCUS <https://numfocus.org>`__,
a non-profit dedicated to supporting the open source scientific computing
community. Please consider `making a donation
<https://numfocus.org/donate-to-cantera>`__ 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
