The Multi-Species Multi-Reaction (MSMR) model provides a thermodynamically consistent framework for describing lithium insertion electrodes. This guide covers the theoretical foundations and practical applications.Documentation Index
Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt
Use this file to discover all available pages before exploring further.
Electrode Model Equations
Thermodynamics
The MSMR model assumes that all electrochemical reactions at the electrode/electrolyte interface in a lithium insertion cell can be expressed as: For each species , a vacant host site can accommodate one lithium, leading to a filled host site .Open-Circuit Voltage
The OCV for each reaction is written as: where:- with , , and being the universal gas constant, temperature, and Faraday’s constant
- is the total fraction of available host sites for species
- is the fraction of filled sites occupied by species
- is the concentration-independent standard electrode potential
- is a dimensionless parameter describing the disorder level
Inverse Form
The equation can be inverted to give: The overall electrode stoichiometry is:This provides an explicit closed-form expression for the inverse of the OCV, which is the opposite of many battery models that give OCV as an explicit function of stoichiometry.
Kinetics
The kinetics of the insertion reaction are given by: where is the overpotential, and the exchange current density is:Solid Phase Transport
Within the MSMR framework, the flux within particles is expressed in terms of the chemical potential gradient: Ignoring volumetric expansion (), this simplifies to: The mass balance becomes:Boundary Conditions
For a radially symmetric spherical particle: where is the particle radius. To avoid evaluating and explicitly, we transform to use as the dependent variable, yielding:Fitting OCP Functions to Data
Fitting OCP models to data presents three key challenges.The Missing-Data Problem
At any point in time, the measured half-cell terminal voltage can be modeled as: As a result, the half cell never lithiates all the way to even though the measured terminal voltage reaches . The horizontal gaps between discharge and charge curves at the voltage limits represent the “missing-data problem.”The Inaccessible-Lithium Problem
Laboratory tests only cycle between and , meaning:- Absolute stoichiometry at
- Absolute stoichiometry at
MSMR as a Solution
By regressing independent parameter sets for discharge and charge: We can estimate the underlying OCP by averaging the two parameter sets, which are now expressed in terms of absolute degree of lithiation.Generating Standard U(x) Curves
Unlike typical OCP models, MSMR gives stoichiometry as a function of voltage. To generate lookup tables:- Evaluate the MSMR model over a given voltage range
- Specify the number of evaluation points
- Use the resulting arrays to construct an interpolant for other models
Full-Cell Balance
Using half-cell parameters, we perform electrode balance to get the full-cell OCP: where is full-cell SOC and , are electrode stoichiometries. The conversion between stoichiometry and SOC is:Capacity-Based Formulation
In practice, full-cell OCV data is given in terms of capacity. The reformulation: where , , . We fit the “lower excess capacity” and “upper excess capacity” instead of stoichiometries at 0% and 100% SOC, as the data typically does not reach the true endpoints.Blended MSMR / Experimental OCP
TheOCPDataInterpolantMSMRExtrapolation calculation creates a blended OCP interpolant that combines:
- Experimental data (in the measured range)
- MSMR model extrapolation (outside the measured range)
Blending Function
where is a bump function that transitions from inside the data range to outside it.Diffusivity in MSMR
The solid-phase transport equation within MSMR includes a thermodynamic factor: The term can be computed directly from the MSMR parameters, making MSMR particularly useful for modeling concentration-dependent diffusivity.SOC-Dependent Diffusivity
Diffusivity often varies significantly with state of charge—by 2-3 orders of magnitude in graphite near phase transitions. For empirical SOC-dependent diffusivity without MSMR, use piecewise interpolation.Characteristic Diffusion Time
The diffusion time scale determines rate capability: where is particle radius. At 1C, should be roughly 1 hour for the diffusion process to keep up with the electrochemistry.References
- Verbrugge, Mark, et al. “Thermodynamic model for substitutional materials: application to lithiated graphite, spinel manganese oxide, iron phosphate, and layered nickel-manganese-cobalt oxide.” Journal of The Electrochemical Society 164.11 (2017): E3243.
- Lu, Dongliang, et al. “Implementation of a physics-based model for half-cell open-circuit potential and full-cell open-circuit voltage estimates: part I. Processing half-cell data.” Journal of The Electrochemical Society 168.7 (2021): 070532.