MATLAB Script for Insights into Chemo-Mechanical Yielding and Eigenstrains in Lithium-Ion Battery Degradation

This repository contains MATLAB script developed for the analytical modeling of chemo-mechanical stress and eigenstrain formation in lithium-ion battery electrodes during lithiation and delithiation for the quantification of residual stresses. The scripts implement a one-dimensional diffusion-mechanics framework that couples Fick's lithium transport with an elastic–perfectly plastic constitutive model, enabling the prediction of lithium concentration profiles, stress evolution, and plastic strain distribution throughout the electrode thickness. The framework also includes a fracture-aware capping scheme that simulates microcrack-induced stress relaxation by proportionally reducing plastic eigenstrain in overstressed regions. Users can modify key parameters such as electrode thickness, lithium diffusivity, yield strength, and Vegard’s coefficient to perform parametric studies or extend the analysis to other electrode materials. All plots and results presented in the associated manuscript are fully reproducible using the provided MATLAB code. This resource supports further research on chemo-mechanical degradation mechanisms, residual stress modeling, and eigenstrain-based analysis of battery electrode integrity.