When configuring a battery model, you may encounter several types of voltage and stoichiometry limits. This guide clarifies what each set of limits means, how they are used in simulation and parameter fitting, and why they all exist.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.
Voltage Limits
Voltage limits define the operating range of the cell. These values are critical for safety, model realism, and aligning with experimental protocols.Cut-off Voltages
Lower voltage cut-off/Upper voltage cut-off
OCV at SOC Endpoints
- Open-circuit voltage at 0% / 100% SOC
Stoichiometry Limits
Stoichiometry describes the relative lithium content in each electrode and is central to determining electrode balancing and usable lithium.Stoichiometry at 0%/100% SOC
- Negative/positive electrode stoichiometry at 0%/100% SOC
- Initial lithium concentrations
- Electrode balancing
Stoichiometry at Min/Max SOC
- Negative/positive electrode stoichiometry at minimum/maximum SOC
These parameters provide better numerical convergence during fitting and help guide the optimization algorithm.
Lower/Upper Excess Capacity
- Negative/positive electrode lower/upper excess capacity
How These Fit Together
Calculate Initial Conditions
Use stoichiometry limits to compute initial concentrations and cyclable lithium
Stoichiometry Sign Convention
| Electrode | SOC | Stoichiometry | Reason |
|---|---|---|---|
| Negative | 0% | Lower | Delithiated during discharge |
| Negative | 100% | Higher | Lithiated during charge |
| Positive | 0% | Higher | Lithiated during discharge |
| Positive | 100% | Lower | Delithiated during charge |
Summary Table
| Parameter Type | Used In | Purpose |
|---|---|---|
| Cut-off voltages | Simulation | Operational safety bounds |
| OCV at 0%/100% SOC | Parameterization | Stoichiometry range reference |
| Stoichiometry at 0%/100% SOC | Simulation | Initial concentrations, electrode balance |
| Stoichiometry at min/max SOC | Fitting only | Numerical convergence, optimization guidance |
| Excess capacity | Fitting only | Unused lithiation capacity |
While having multiple definitions may seem excessive, each serves a specific role in maintaining model fidelity, improving fitting stability, and aligning with experimental protocols.