Skip to content

Commit

Permalink
Added kinetics documentation
Browse files Browse the repository at this point in the history
- a detailed list of all available libraries and their description
- examples of all libraries kinetic formats
- a note regarding the implementation of a specificCollider
  • Loading branch information
alongd committed Jul 17, 2017
1 parent 6f717bc commit ee625bb
Show file tree
Hide file tree
Showing 2 changed files with 266 additions and 3 deletions.
104 changes: 102 additions & 2 deletions documentation/source/users/rmg/database/kinetics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,9 @@ RMG always chooses to use kinetics from libraries over families. If multiple lib
contain the same reaction, then precedence is given to whichever library is
listed first in the input.py file.

For combustion mechanisms, you should always use *one* small-molecule
combustion library, such as the pre-packaged ERC-Foundation Fuel.
For combustion mechanisms, you should always use at least one small-molecule
combustion library, such as the pre-packaged *BurkeH2O2* and/or *FFCM1*
for natural gas.
The reactions contained in these libraries are poorly estimated by kinetic
families and are universally important to combustion systems.

Expand All @@ -49,6 +50,105 @@ Kinetic libraries should also be used in the cases where:
* No family exists for the class of reaction
* You are not confident about the accuracy of kinetic parameters

Below is a list of pre-packaged kinetics library reactions in RMG:



+---------------------------------------+------------------------------------------------------------------------------------------+
|Library |Description |
+=======================================+==========================================================================================+
|1989_Stewart_2CH3_to_C2H5_H |Chemically Activated Methyl Recombination to Ethyl (2CH3 -> C2H5 + H) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|2001_Tokmakov_H_Toluene_to_CH3_Benzene |H + Toluene = CH3 + Benzene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|2005_Senosiain_OH_C2H2 |pathways on the OH + acetylene surface |
+---------------------------------------+------------------------------------------------------------------------------------------+
|2006_Joshi_OH_CO |pathways on OH + CO = HOCO = H + CO2 surface |
+---------------------------------------+------------------------------------------------------------------------------------------+
|BurkeH2O2inArHe |Comprehensive H2/O2 kinetic model in Ar or He atmosphere |
+---------------------------------------+------------------------------------------------------------------------------------------+
|BurkeH2O2inN2 |Comprehensive H2/O2 kinetic model in N2 atmosphere |
+---------------------------------------+------------------------------------------------------------------------------------------+
|C10H11 |Cyclopentadiene pyrolysis in the presence of ethene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|C3 |Cyclopentadiene pyrolysis in the presence of ethene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|C6H5_C4H4_Mebel |Formation Mechanism of Naphthalene and Indene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Chernov |Soot Formation with C1 and C2 Fuels (aromatic reactions only) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|CurranPentane |Ignition of pentane isomers |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Dooley |Methyl formate (contains several mechanisms) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|ERC-FoundationFuelv0.9 |Small molecule combustio (natural gas) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Ethylamine |Ethylamine pyrolysis and oxidation |
+---------------------------------------+------------------------------------------------------------------------------------------+
|FFCM1(-) |Foundational Fuel Chemistry Model Version 1.0 (excited species removed) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Fulvene_H |Cyclopentadiene pyrolysis in the presence of ethene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|GRI-HCO |The `HCO <=> H + CO` reaction |
+---------------------------------------+------------------------------------------------------------------------------------------+
|GRI-Mech3.0 |Gas Research Institute natural gas mechanism optimized for 1 atm (discountinued Feb. 2000)|
+---------------------------------------+------------------------------------------------------------------------------------------+
|GRI-Mech3.0-N |GRI-Mech3.0 including nitrogen chemistry (NOx from N2) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Glarborg |Mechanisms by P. Glarborg, assorted by carbon number |
+---------------------------------------+------------------------------------------------------------------------------------------+
|JetSurF2.0 |Jet Surrogate Fuel model up tp C12 (excited species removed) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Mebel_C6H5_C2H2 |Pathways from benzene to naphthalene |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Mebel_Naphthyl |Reactions of naphthyl-1 and naphthyl-2 |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Methylformate |Methyl formate |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Narayanaswamy |Oxidation of substituted aromatic species (aromatic reactions only) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Nitrogen_Dean_and_Bozzelli |Combustion Chemistry of Nitrogen |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Nitrogen_Glarborg_Gimenez_et_al |High pressure C2H4 oxidation with nitrogen chemistry |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Nitrogen_Glarborg_Lucassen_et_al |Fuel-nitrogen conversion in the combustion of small amines |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Nitrogen_Glarborg_Zhang_et_al |Premixed nitroethane flames at low pressure |
+---------------------------------------+------------------------------------------------------------------------------------------+
|OxygenSingTrip |Reactions of singlet and triplet oxygen |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/DMDS |Dimethyl disulfide (CH3SSCH3) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/DMS |Dimethyl disulfide (CH3SSCH3) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/DTBS |Di-tert-butyl Sulfide (C4H9SSC4H9) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/Hexanethial_nr |Hexyl sulfide (C6H13SC6H13) + hexadecane (C16H34) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/Sendt |Small sulfur molecule |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/TP_Song |Thiophene (C4H4S, aromatic) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|Sulfur/Thial_Hydrolysis |Thioformaldehyde (CH2S) and thioacetaldehyde (C2H4S) to COS and CO2 |
+---------------------------------------+------------------------------------------------------------------------------------------+
|TEOS |Organic oxidized silicone |
+---------------------------------------+------------------------------------------------------------------------------------------+
|c-C5H5_CH3_Sharma |Cyclopentadienyl + CH3 |
+---------------------------------------+------------------------------------------------------------------------------------------+
|combustion_core |Leeds University natural gas mechanism (contains versions 2-5) |
+---------------------------------------+------------------------------------------------------------------------------------------+
|fascella |Cyclopentadienyl + acetyl |
+---------------------------------------+------------------------------------------------------------------------------------------+
|kislovB |Formation of indene in combustion |
+---------------------------------------+------------------------------------------------------------------------------------------+
|naphthalene_H |Cyclopentadiene pyrolysis in the presence of ethene Part 1 |
+---------------------------------------+------------------------------------------------------------------------------------------+
|vinylCPD_H |Cyclopentadiene pyrolysis in the presence of ethene Part 2 |
+---------------------------------------+------------------------------------------------------------------------------------------+




.. _kineticsFamilies:

Families
Expand Down
Loading

0 comments on commit ee625bb

Please sign in to comment.