Skip to main content

Crate tpt_sci_kinetics

Crate tpt_sci_kinetics 

Source
Expand description

§tpt-sci-kinetics

Heterogeneous and surface chemical kinetics for the tpt-science pillar, built from scratch on top of tpt_sci_reaction_network’s mass-action engine (tpt_sci_ode backend).

The crate adds the two kinetic building blocks most often needed for catalysis / reactor modelling that plain mass-action CRNs lack:

  • Arrhenius temperature dependence. Each reaction carries a pre-exponential factor A and activation energy Ea; its rate constant follows k(T) = A·exp(-Ea / (R·T)) (ArrheniusRate).
  • Langmuir–Hinshelwood adsorption / surface coverage. A small site-balance solver computes fractional surface coverages θ_i from gas-phase partial pressures and adsorption equilibria, feeding surface-reaction rates that are first order in coverage rather than in gas concentration (langmuir_hinshelwood_coverages), generalized to multiple independent site types via multi_site_langmuir_hinshelwood_coverages.
  • Eley–Rideal mechanism. EleyRideal models a step where one reactant is adsorbed (subject to LH coverage) and the other reacts directly from the gas phase, r = k·θ_adsorbed·[gas_phase], pluggable into a ReactionSystem via EleyRideal::into_rate_law.
  • Coverage-dependent activation energy. CoverageDependentArrheniusRate extends the Arrhenius law with a linear Brønsted–Evans–Polanyi-style dependence Ea(θ) = Ea0 + α·θ, giving k(T, θ) = A·exp(-Ea(θ)/(R·T)).

An KineticsProblem ties an Arrhenius-rate ReactionSystem to a temperature profile and integrates it with tpt-sci-ode.

§Example

use tpt_sci_kinetics::{ArrheniusRate, langmuir_hinshelwood_coverages};

// Unimolecular decay with A = 1e13, Ea = 80 kJ/mol.
let r = ArrheniusRate::new(1.0e13, 80_000.0).unwrap();
let k = r.rate_constant(800.0); // T = 800 K
assert!(k > 0.0 && k.is_finite());

// Two competing adsorbates on a single site type; coverages sum to <= 1.
let theta = langmuir_hinshelwood_coverages(&[1.0, 2.0], &[0.5, 1.0]).unwrap();
let sum: f64 = theta.iter().sum();
assert!(sum <= 1.0 + 1e-9 && sum > 0.0);

Structs§

ArrheniusRate
An Arrhenius rate constant k(T) = A·exp(-Ea / (R·T)).
CoverageDependentArrheniusRate
An Arrhenius rate constant with a coverage-dependent activation energy, k(T, θ) = A·exp(-Ea(θ) / (R·T)) with the linear (Brønsted–Evans–Polanyi style) dependence Ea(θ) = Ea0 + α·θ.
EleyRideal
An Eley–Rideal surface reaction step: one reactant is adsorbed (its fractional coverage θ is subject to Langmuir–Hinshelwood site-balance normalization) while the other reacts directly from the gas phase without itself adsorbing. The rate law is first order in each, r = k · θ_adsorbed · [gas_phase], in contrast to the pure Langmuir–Hinshelwood mechanism r = k · θ_A · θ_B where both reactants are adsorbed.
KineticsProblem
A kinetics problem: a mass-action ReactionSystem whose rate constants are overwritten with Arrhenius expressions as a function of a supplied temperature.

Enums§

KineticsError
Errors raised by the kinetics engine.

Constants§

R_GAS
Universal gas constant R (J·mol⁻¹·K⁻¹). Molar gas constant, J·mol⁻¹·K⁻¹ (the shared value from tpt-sci-units).

Functions§

langmuir_hinshelwood_coverages
Compute Langmuir–Hinshelwood fractional surface coverages for a single site type given per-species adsorption equilibrium constants K_i and (partial) pressures p_i.
multi_site_langmuir_hinshelwood_coverages
Compute Langmuir–Hinshelwood fractional surface coverages for multiple distinct site types, e.g. species that adsorb on site type A vs species that adsorb on an independent site type B (each with its own site-balance normalization).