pyMARS

Python-based (chemical kinetic) Model Automatic Reduction Software (pyMARS) implements multiple techniques for reducing the size and complexity of detailed chemical kinetic models.

An installation guide, usage examples, theory details, and API docs are provided in the online documentation: https://Niemeyer-Research-Group.github.io/pyMARS/

pyMARS currently consists of four methods for model reduction:

Directed relation graph (DRG)
Directed relation graph with error propagation (DRGEP)
Path flux analysis (PFA)
Sensitivity analysis (SA)

Sensitivity analysis may be run following one of the first three methods, or directly on the starting model; however, its computational expense is high, and applying this method alone is not recommended.

Installation

pyMARS supports Python 3.7, 3.8, and 3.9, and can be installed easily using conda:

conda install -c cantera cantera
conda install -c niemeyer-research-group pymars

Usage

For detailed usage examples, see the online documentation. Once installed, the list of options can be found with:

pymars --help

pyMARS requires models in the Cantera format. However, running pyMARS with a CHEMKIN file will convert it into a Cantera file. pyMARS also provides the --convert option to convert a given model to/from the CHEMKIN format.

Citation

Please refer to the CITATION file for information about citing pyMARS when used in a scholarly work.

If you use this package as part of a scholarly publication, please consider citing the appropriate theory/method papers in addition to the software itself.

License

pyMARS is released under the MIT license; see LICENSE for details.

Code of Conduct

To ensure an open and welcoming community, pyMARS adheres to a code of conduct adapted from the Contributor Covenant code of conduct.