v0.2.0 - Temperature-aware battery modeling
Highlights
- Adds a temperature-aware battery equivalent-circuit example in base MATLAB.
- Couples irreversible electrical losses to a single-node thermal energy balance.
- Feeds lumped cell temperature back into ohmic resistance.
- Includes plotting and no-plot entry points, explicit assumptions, physical bounds, and an energy-conservation assertion.
- Documents the expected 37.32 degC peak temperature, 28.95 degC final temperature, 33.32 W peak irreversible heat, and 0.608 final SOC for the included pulse case.
Validation
- MATLAB R2026a
mlintreports no findings for both new scripts. - The pull request link-check workflow passed.
- An independent execution of the same discrete equations reproduced the documented outputs and a thermal energy-balance residual below 1e-6 J.
- Full local MATLAB batch execution was unavailable because the installed R2026a instance could not obtain a license; run
check_battery_thermal_modelin a licensed MATLAB session for native execution.
Scope
This remains an educational reference model. Parameters are not fitted to a specific cell, and the model excludes spatial gradients, reversible entropic heat, aging, hysteresis, thermal runaway, and pack-level interactions.
See the implementation and review history in #70.