Skip to main content

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.

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.

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: Li++e+Hj(Li–H)j\text{Li}^+ + \text{e}^- + \text{H}_j \rightleftharpoons (\text{Li--H})_j For each species jj, a vacant host site Hj\text{H}_j can accommodate one lithium, leading to a filled host site (Li–H)j(\text{Li--H})_j.

Open-Circuit Voltage

The OCV for each reaction is written as: Uj=Uj0+ωjflog(Xjxjxj)U_j = U_j^0 + \frac{\omega_j}{f} \log\left(\frac{X_j - x_j}{x_j}\right) where:
  • f=F/(RT)f = F/(RT) with RR, TT, and FF being the universal gas constant, temperature, and Faraday’s constant
  • XjX_j is the total fraction of available host sites for species jj
  • xjx_j is the fraction of filled sites occupied by species jj
  • Uj0U_j^0 is the concentration-independent standard electrode potential
  • ωj\omega_j is a dimensionless parameter describing the disorder level

Inverse Form

The equation can be inverted to give: xj=Xj1+exp[f(UUj0)/ωj]x_j = \frac{X_j}{1 + \exp[f(U - U_j^0)/\omega_j]} The overall electrode stoichiometry is: x=jxj=jXj1+exp[f(UUj0)/ωj]x = \sum_j x_j = \sum_j \frac{X_j}{1 + \exp[f(U - U_j^0)/\omega_j]}
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: ij=i0,j[e(1αj)fηeαjfη],i=jiji_j = i_{0,j}[e^{(1-\alpha_j)f\eta} - e^{-\alpha_j f\eta}], \quad i = \sum_j i_j where η=ϕsϕeU(x)\eta = \phi_s - \phi_e - U(x) is the overpotential, and the exchange current density is: i0,j=i0,jref(xj)ωjαj(Xjxj)ωj(1αj)(ce/ceref)1αji_{0,j} = i_{0,j}^{ref} (x_j)^{\omega_j \alpha_j} (X_j - x_j)^{\omega_j(1-\alpha_j)} (c_e/c_e^{ref})^{1-\alpha_j}

Solid Phase Transport

Within the MSMR framework, the flux within particles is expressed in terms of the chemical potential gradient: N=cTxDRTμ+x(N+NH)N = -c_T x \frac{D}{RT} \nabla\mu + x(N + N_H) Ignoring volumetric expansion (N+NH=0N + N_H = 0), this simplifies to: N=cTfDx(1x)dUdxxN = c_T f D x(1-x) \frac{dU}{dx} \nabla x The mass balance becomes: xt=(x(1x)fDdUdxx)\frac{\partial x}{\partial t} = -\nabla \cdot \left( x(1-x) f D \frac{dU}{dx} \nabla x \right)

Boundary Conditions

For a radially symmetric spherical particle: Nr=0=0,Nr=R=iFN\big|_{r=0} = 0, \quad N\big|_{r=R} = \frac{i}{F} where RR is the particle radius. To avoid evaluating U(x)U(x) and dU/dxdU/dx explicitly, we transform to use UU as the dependent variable, yielding: dUdxUt=(x(1x)fDx)\frac{dU}{dx} \frac{\partial U}{\partial t} = -\nabla \cdot \left( x(1-x) f D \nabla x \right)

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: V(t)=Uocp(x(t))+hysteresisimpedance×currentV(t) = U_{\text{ocp}}(x(t)) + \text{hysteresis} - \text{impedance} \times \text{current} As a result, the half cell never lithiates all the way to Uocp=VminU_{\text{ocp}} = V_{\text{min}} even though the measured terminal voltage reaches VminV_{\text{min}}. 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 VminV_{\text{min}} and VmaxV_{\text{max}}, meaning:
  • Absolute stoichiometry θs1\theta_s \neq 1 at VminV_{\text{min}}
  • Absolute stoichiometry θs0\theta_s \neq 0 at VmaxV_{\text{max}}
There are portions of active materials never accessed by OCP tests since we cannot achieve high-enough or low-enough voltages in practical laboratory tests.

MSMR as a Solution

By regressing independent parameter sets for discharge and charge: {Uj0,Xj,ωj,θmin,θmax}dis\{U_j^0, X_j, \omega_j, \theta_{\text{min}}, \theta_{\text{max}}\}_{\text{dis}} {Uj0,Xj,ωj,θmin,θmax}chg\{U_j^0, X_j, \omega_j, \theta_{\text{min}}, \theta_{\text{max}}\}_{\text{chg}} 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:
  1. Evaluate the MSMR model over a given voltage range
  2. Specify the number of evaluation points
  3. 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: Ucell(z)=Up(θp)Un(θn)U_{\text{cell}}(z) = U_p(\theta_p) - U_n(\theta_n) where zz is full-cell SOC and θn\theta_n, θp\theta_p are electrode stoichiometries. The conversion between stoichiometry and SOC is: z=θnθn0θn100θn0=θpθp0θp100θp0z = \frac{\theta_n - \theta_n^0}{\theta_n^{100} - \theta_n^0} = \frac{\theta_p - \theta_p^0}{\theta_p^{100} - \theta_p^0}

Capacity-Based Formulation

In practice, full-cell OCV data is given in terms of capacity. The reformulation: Ucell(q)=Up(qp)Un(qn)U_{\text{cell}}(q) = U_p(q_p) - U_n(q_n) where q=Qzq = Qz, qn=θnQnq_n = \theta_n Q_n, qp=θpQpq_p = \theta_p Q_p. 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

The OCPDataInterpolantMSMRExtrapolation calculation creates a blended OCP interpolant that combines:
  • Experimental data (in the measured range)
  • MSMR model extrapolation (outside the measured range)

Blending Function

V(x)=w(x)Vocp(x)+(1w(x))Vmsmr-corrected(x)V(x) = w(x) \cdot V_{\text{ocp}}(x) + (1 - w(x)) \cdot V_{\text{msmr-corrected}}(x) where w(x)w(x) is a CC^\infty bump function that transitions from 1\approx 1 inside the data range to 0\approx 0 outside it.
The transition_fraction parameter (typically 0.05-0.15) controls the transition region width, balancing data fidelity and smoothness.

Diffusivity in MSMR

The solid-phase transport equation within MSMR includes a thermodynamic factor: N=cTfDx(1x)dUdxxN = c_T f D x(1-x) \frac{dU}{dx} \nabla x The term dUdx\frac{dU}{dx} 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: τD=R2D\tau_D = \frac{R^2}{D} where RR is particle radius. At 1C, τD\tau_D should be roughly 1 hour for the diffusion process to keep up with the electrochemistry.

References

  1. 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.
  2. 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.