Before running a simulation, you need to specify how lithium is distributed in each electrode. This determines the starting state of charge and affects the entire simulation. The Electrode State of Health (ESOH) algorithm finds the stoichiometry windows that map cell SOC to electrode lithiation states.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.
Why Initialization Matters
The initial concentration distribution affects:- Starting voltage: The cell begins at the OCV corresponding to the initial stoichiometry
- Available capacity: How much charge can be extracted before hitting voltage limits
- Simulation accuracy: Incorrect initialization leads to incorrect predictions throughout the simulation
The ESOH Problem
When you measure a full-cell OCV curve, you observe the difference between electrode potentials: But the cell voltage alone doesn’t tell you the individual electrode stoichiometries. The ESOH algorithm solves this inverse problem by finding the stoichiometry windows that explain the full-cell OCV.What ESOH Determines
| Parameter | Meaning |
|---|---|
| Negative stoichiometry at 0% SOC | |
| Negative stoichiometry at 100% SOC | |
| Positive stoichiometry at 0% SOC | |
| Positive stoichiometry at 100% SOC |
Calculation of Minimum and Maximum Stoichiometries
First, the minimum and maximum stoichiometries in each electrode (based on the voltage range) must be calculated.Required Parameters
Initial concentration in <electrode> electrode [mol.m-3]()Voltage at 100% SOC [V]()Voltage at 0% SOC [V]()
System of Equations
The stoichiometries are found by solving: where and are the stoichiometries of the positive and negative electrodes respectively, the subscript indicates the SOC percentage, is temperature, and is the open-circuit potential function.Cyclable Lithium Constraint
By default, cyclable lithium inventory () is used as the constraint to fully define the system: where is given by:Electrode Capacity Calculation
Each electrode capacity is calculated as: where is electrode area, is electrode thickness, and is the active material volume fraction.Initialization Options
- Option 1: Direct Concentration
- Option 2: Specify SOC
- Option 3: Specify OCV
Directly Specify Initial Concentration
The solver uses the value corresponding toInitial concentration in <electrode> electrode [mol.m-3] in the parameters object. To change the value, simply modify this parameter.Initialization in Ionworks Pipeline
Ionworks Pipeline provides all of the above initialization methods via theparameters interface.
This approach is suitable when the step before the first step to be fit is a long rest step. See the example notebooks for more details on using the
parameters interface.References
- Mohtat, Peyman, et al. “Towards better estimability of electrode-specific state of health: Decoding the cell expansion.” Journal of Power Sources 427 (2019): 101-111.
- Weng, Andrew, et al. “Modeling battery formation: Boosted sei growth, multi-species reactions, and irreversible expansion.” Journal of The Electrochemical Society 170.9 (2023): 090523.