tpt-sci-kinetics 0.1.1

Surface and heterogeneous kinetics (Arrhenius, Langmuir-Hinshelwood) extending the mass-action CRN engine, for the tpt-science pillar
Documentation

tpt-sci-kinetics

Surface and heterogeneous chemical kinetics for the tpt-science pillar, built from scratch on top of tpt-sci-reaction-network (the mass-action CRN engine) and tpt-sci-ode.

Features

  • ArrheniusRate — k(T) = A·exp(-Ea/(R·T)), validated (new), temperature driven (rate_constant). R_GAS is the universal gas constant.
  • langmuir_hinshelwood_coverages — single-site fractional surface coverages θ_i = K_i·p_i / (1 + Σ K_j·p_j) from adsorption equilibria + partial pressures (coverages sum to ≤ 1).
  • multi_site_langmuir_hinshelwood_coverages — the same isotherm generalized to multiple independent site types (e.g. species adsorbing on site type A vs site type B), normalizing each site type's coverages separately; reduces to langmuir_hinshelwood_coverages for a single site type.
  • EleyRideal — Eley–Rideal surface mechanism where one reactant is adsorbed (LH coverage θ) and the other reacts directly from the gas phase, r = k·θ_adsorbed·[gas_phase]; into_rate_law plugs it in as a tpt-sci-reaction-network RateLaw::Custom closure.
  • CoverageDependentArrheniusRate — Arrhenius rate with a linear Brønsted–Evans–Polanyi-style coverage-dependent activation energy Ea(θ) = Ea0 + α·θ, giving k(T, θ) = A·exp(-Ea(θ)/(R·T)).
  • KineticsProblem — binds an Arrhenius ReactionSystem to a temperature (rate_constants), integrating with tpt-sci-ode.

These are the two kinetic building blocks most reactor/catalysis models need on top of plain mass-action CRNs.

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);

The reactor example (cargo run --example reactor -p tpt-sci-kinetics) wires an Arrhenius-rate reaction system into a temperature-driven solve.

Scope (v1)

Arrhenius temperature dependence and Langmuir–Hinshelwood surface coverage (single- and multi-site), the Eley–Rideal mechanism, and linear coverage-dependent activation energy — the building blocks most reactor/catalysis models need on top of plain mass-action CRNs. Further micro-kinetic detail (e.g. nonlinear coverage dependence, lateral-interaction lattice models, multi-step elementary mechanisms beyond LH/ER) is out of scope for v1.

License

Licensed under either of MIT or Apache-2.0 at your option.