Reaction events¶
Microcanonical rate coefficients¶

rmgpy.pdep.
calculateMicrocanonicalRateCoefficient
(reaction, ndarray Elist, ndarray Jlist, ndarray reacDensStates, ndarray prodDensStates=None, double T=0.0)¶ Calculate the microcanonical rate coefficient \(k(E)\) for the reaction reaction at the energies Elist in J/mol. reacDensStates and prodDensStates are the densities of states of the reactant and product configurations for this reaction. If the reaction is irreversible, only the reactant density of states is required; if the reaction is reversible, then both are required. This function will try to use the best method that it can based on the input data available:
 If detailed information has been provided for the transition state (i.e. the molecular degrees of freedom), then RRKM theory will be used.
 If the above is not possible but highpressure limit kinetics \(k_\infty(T)\) have been provided, then the inverse Laplace transform method will be used.
The density of states for the product prodDensStates and the temperature of interest T in K can also be provided. For isomerization and association reactions prodDensStates is required; for dissociation reactions it is optional. The temperature is used if provided in the detailed balance expression to determine the reverse kinetics, and in certain cases in the inverse Laplace transform method.
RRKM theory¶

rmgpy.pdep.
applyRRKMTheory
(transitionState, ndarray Elist, ndarray Jlist, ndarray densStates)¶ Calculate the microcanonical rate coefficient for a reaction using RRKM theory, where transitionState is the transition state of the reaction, Elist is the array of energies in J/mol at which to evaluate the microcanonial rate, and densStates is the density of states of the reactant.
RRKM (RiceRamspergerKasselMarcus) theory is the microcanonical analogue of transition state theory. The microcanonical rate coefficient as a function of total energy \(E\) and total angular momentum quantum number \(J\) is given by
\[k(E,J) = \frac{N^\ddagger(E, J)}{h \rho(E, J)}\]where \(N^\ddagger(E, J)\) is the sum of states of the transition state and \(\rho(E, J)\) is the density of states of the reactant. If the Jrotor is treated as active, the Jdependence can be averaged in the above expression to give
\[k(E) = \frac{N^\ddagger(E)}{h \rho(E)}\]as a function of total energy alone. This is reasonable at high temperatures, but less accurate at low temperatures.
Use of RRKM theory requires detailed information about the statistical mechanics of the reactant and transition state. However, it is generally more accurate than the inverse Laplace transform method.
Inverse Laplace transform method¶

rmgpy.pdep.
applyInverseLaplaceTransformMethod
(transitionState, Arrhenius kinetics, ndarray Elist, ndarray Jlist, ndarray densStates, double T=0.0)¶ Calculate the microcanonical rate coefficient for a reaction using the inverse Laplace transform method, where kinetics is the high pressure limit rate coefficient, E0 is the groundstate energy of the transition state, Elist is the array of energies in kJ/mol at which to evaluate the microcanonial rate, and densStates is the density of states of the reactant. The temperature T in K is not required, and is only used when the temperature exponent of the Arrhenius expression is negative (for which the inverse transform is undefined).
The inverse Laplace transform method exploits the following relationship to determine the microcanonical rate coefficient:
\[\mathcal{L} \left[k(E) \rho(E) \right] = \int_0^\infty k(E) \rho(E) e^{E/k_\mathrm{B} T} \ dE = k_\infty(T) Q(T)\]Given a highpressure limit rate coefficient \(k_\infty(T)\) represented as an Arrhenius expression with positive \(n\) and \(E_\mathrm{a}\), the microcanonical rate coefficient \(k(E)\) can be determined via an inverse Laplace transform. For \(n = 0\) the transform can be defined analytically:
\[k(E) = A \frac{\rho(E  E_\mathrm{a})}{\rho(E)} \ \ \ \ (n = 0)\]For \(n > 0\) the transform is defined numerically. For \(n < 0\) or \(E_\mathrm{a} < 0\) the transform is not defined; in this case we approximate by simply lumping the \(T^n\) or \(e^{E_\mathrm{a}/RT}\) terms into the preexponential factor, and use a different \(k(E)\) at each temperature.
The ILT method does not required detailed transition state information, but only the highpressure limit kinetics. However, it assumes that (1) \(k_\infty(T)\) is valid over the temperature range from zero to infinity and (2) the activation energy \(E_\mathrm{a}\) is physically identical to the reaction barrier \(E_0^\ddagger  E_0\).