The Cantera Community¶
Resources to help you participate in the community of Cantera users and developers
Contents
About the Cantera Community¶
Cantera was originally developed by Prof. David G. Goodwin at the California Institute of Technology. Building on Prof. Goodwin's legacy, Cantera is licensed under a permissive 3-Clause BSD license, ensuring that the software will remain open source and available for all to use.
In this vein, Cantera software relies exclusively upon the volunteer contributions of its users. These contributions range from diagnosing and reporting problems/bugs, to helping others learn to use Cantera, to developing and implementing new software capabilities.
While Cantera provides some standalone models and applications, numerous external packages exist that provide more specialized functionality and rely on Cantera. We provide a non-exhaustive list of these affiliated packages.
Governance¶
Cantera is governed by a Steering Committee; more information about our project's governance policies can be found on the governance page.
The Cantera Users' Group¶
The Cantera Users’ Group on Google Groups is the forum where most Cantera users have their questions asked and answered. If you need help using Cantera and cannot find an answer in the tutorials or documentation at Cantera's website, consider joining and asking a question there. A few notes:
Please use the search feature before posting to see if your question has been answered before.
If you are not running the current stable release of Cantera, please upgrade first, and see if the problem persists.
This group is moderated, so it may take some time for your posts to appear if you are a new member.
For installation/compilation problems, please provide:
-
The contents of the
cantera.conf
andconfig.log
files, and the output of thescons build
andscons build dump
commands. You can direct this output to a file calledbuildlog.txt
by running:scons build >buildlog.txt 2>&1
The exact version of Cantera you are trying to compile, and how it was obtained (for example, downloaded source tarball or the specific Git commit).
Your operating system, compiler versions, and the versions of any other relevant software.
For application problems (that is, not related to installation or compilation), please:
Provide a minimal, complete, and verifiable example that demonstrates the problem when making your post; in short this means include a code example and input files.
Please also provide information about your operating system and Cantera version. This will enable other members of the group to efficiently understand the problem and offer suggestions on how to fix it.
Please DO NOT post screenshots of code or error messages! They cannot be searched by anyone looking to solve a similar problem, and also cannot be read by text readers for visually impaired users. Instead, please copy and paste any relevant text directly into your message. Thanks!
Interacting with the Cantera Community¶
Code of Conduct¶
All online and in-person interactions and communications related to Cantera are governed by the Cantera Code of Conduct. This code of conduct sets expectations for the community to ensure that users and contributors are able to participate in a respectful and welcoming environment.
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.
Contributing Code¶
If there is a feature you would like to see added to Cantera, please consider becoming part of the developer community and contributing code! Cantera's code repository is developed openly on GitHub. Contributions are welcomed from anyone in the community; please see the Contributors' guide for assistance in getting started. There are also plenty of current contributors who are happy to help, if you do not know how to get started.
Bug Reporting¶
What should I do if I think I've found a bug in Cantera?
Check to see if you're using the most recent version of Cantera, and upgrade if not.
Check the Issue Tracker to see if the issue has already been reported.
Try to generate a minimal, complete, and verifiable example that demonstrates the observed bug.
Create a new issue on the tracker (the "New Issue" button is toward the upper right-hand corner, just above the list of open issues). Include as much information as possible about your system configuration (operating system, compiler versions, Python versions, installation method, etc.)
What information should I include in my bug report?
The version of Cantera are you using, and how you installed it
The operating system you are using
If you compiled Cantera, what compiler you used, and what compilation options you specified
The version of Python or Matlab are you using, if applicable
The necessary input to generate the reported behavior
The full text of any error message you receive
Supporting Cantera¶
Citing Cantera¶
If you use Cantera in a publication, we would appreciate if you cited the version of Cantera that you used. This helps to improve the reproducibility of your work, as well as giving credit to the many authors who have contributed their time to developing Cantera. The recommended citation for Cantera is as follows:
David G. Goodwin, Harry K. Moffat, Ingmar Schoegl, Raymond L. Speth, and Bryan W. Weber. Cantera: An object-oriented software toolkit for chemical kinetics, thermodynamics, and transport processes. https://www.cantera.org, 2023. Version 3.0.0. doi:10.5281/zenodo.8137090
The following BibTeX entry may also be used:
@misc{cantera,
author = "David G. Goodwin and Harry K. Moffat and Ingmar Schoegl and Raymond L.
Speth and Bryan W. Weber",
title = "Cantera: An Object-oriented Software Toolkit for Chemical
Kinetics, Thermodynamics, and Transport Processes",
year = 2023,
note = "Version 3.0.0",
howpublished = "\url{https://www.cantera.org}",
doi = {10.5281/zenodo.8137090}
}
If you are using a different version of Cantera, update the year
, note
and doi
fields accordingly. You can find the correct DOI for other versions
of Cantera in Cantera's Zenodo Entry.
Donations¶
Finally, please consider financially supporting Cantera's development! Cantera is a fiscally sponsored project of NumFOCUS, a 501(c)3 nonprofit dedicated to supporting the open source scientific computing community. If you have found Cantera to be useful to your research or company, please consider making a donation to support our efforts. All donations will be used exclusively to fund the development of Cantera's source code, documentation, or community.