ansys-chemkin 2025.2.1

Installation

pip is the preferred installation method. You can use pip to install PyChemkin.

pip install ansys-chemkin

import ansys.chemkin

Chemkin version number = xxx

** PyChemkin does not support Chemkin versions older than 2025 R2

Basic usage

Here is a PyChemkin project to compute the density of mixture air. This code shows how to import PyChemkin (Ansys Chemkin) and use some basic capabilities:

import os

# import PyChemkin
import ansys.chemkin as chemkin

# create a Chemistry Set for GRI 3.0 mechanism in the data directory
mech_dir = os.path.join(chemkin.ansys_dir, "reaction", "data")
# set up mechanism file names
mech_file = os.path.join(mech_dir, "grimech30_chem.inp")
therm_file = os.path.join(mech_dir, "grimech30_thermo.dat")
tran_file = os.path.join(mech_dir, "grimech30_transport.dat")
# instantiate Chemistry Set 'GasMech'
GasMech = chemkin.Chemistry(chem=mech_file, therm=therm_file,  tran=tran_file,  label='GRI 3.0')
# pre-process the Chemistry Set
status = GasMech.preprocess()
# check preprocess status
if status != 0:
    # failed
    print(f'PreProcess: error encountered...code = {status:d}')
    print(f'see the summary file {GasMech.summaryfile} for details')
    exit()
# Create Mixture 'air' based on 'GasMech'
air = chemkin.Mixture(GasMech)
# set 'air' condition
# mixture pressure in [dynes/cm2]
air.pressure = 1.0 * chemkin.Patm
# mixture temperature in [K]
air.temperature = 300.0
# mixture composition in mole fractions
air.X = [('O2', 0.21), ('N2', 0.79)]
#
print(f"pressure    = {air.pressure/chemkin.Patm} [atm]")
print(f"temperature = {air.temperature} [K]")
# print the 'air' composition in mass fractions
air.list_composition(mode='mass')
# get 'air' mixture density [g/cm3]
print(f"the mixture density = {air.RHO} [g/cm3]")

For comprehensive usage information, see the Tutorials in the PyChemkin documentation.

Documentation and issues

Documentation for the latest stable release of PyChemkin is hosted at PyChemkin documentation.

In the upper right corner of the documentation’s title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.

User manuals and tutorials for Chemkin can be found at Chemkin Documents.

On the PyAnsys Chemkin Issues page, you can create issues to report bugs and request new features. On the PyChemkin Discussions page or the Discussions page on the Ansys Developer portal, you can post questions, share ideas, and get community feedback.

To reach the project support team, email pyansys.core@ansys.com.