Open model laboratory · MATLAB/Simulink
MATLAB Simulink Energy Lab.
Run compact battery, thermal, state-estimation, and converter models whose assumptions stay visible from equation to validation result.
Version 0.6.0 result
The finite-volume model resolves surface temperatures, an internal hot spot, through-thickness gradients, and asymmetric boundary heat removal.
Multiphysics thermal modeling
Resolve the internal hot spot across a pouch cell.
The one-dimensional finite-volume model represents layered through-thickness conduction with unequal convection at the two broad faces. Its validation case reaches a 43.83 °C peak at 5.60 mm and 1800 s, with a 3.09 °C peak spatial spread.
A symmetric-boundary benchmark agrees with the analytical steady solution within 0.003 °C, while the medium-to-fine grid difference is 0.0024 °C.
Inspect equations, assumptions, and checksModel catalogue
Move from electrical dynamics to thermal and control evidence.
Battery dynamics
First-order and two-RC equivalent-circuit models expose SOC, terminal voltage, fast and slow polarization, and pulse recovery.
Inspect the two-RC modelReal-time SOC estimation
A two-state extended Kalman filter corrects a biased SOC prior using noisy current and terminal-voltage measurements.
Inspect the SOC EKFBattery thermal management
Cell, module, and pouch-cell models expose heat generation, cooling sensitivity, thermal-limit exposure, coolant-path nonuniformity, and spatial gradients.
Inspect the pouch-cell thermal modelPower converters
Average-value, switching, closed-loop, and native Simulink references connect duty cycle and controller choices to voltage, current, ripple, and settling metrics.
Inspect controller comparisonsVerification path
Run every check from one command.
Browser entry point
Open the repository in MATLAB Online and run addpath('examples'); run_all_checks from the project root.
Deterministic evidence
Each check asserts physical, numerical, dimensional, or cross-model invariants without relying on plot inspection.
Continuous validation
GitHub Actions runs the executable model checks whenever MATLAB or Simulink implementation files change.
Review validation runsCitable release
Versioned releases, citation metadata, an ORCID-linked author record, and an MIT license keep reuse and attribution explicit.
Review the latest releaseEngineering boundary
Use transparent baselines before qualified design models.
The examples are educational references, not calibrated design authorities. They omit selected electrochemical, ageing, multidimensional, switching-loss, tolerance, and safety effects by design. Replace illustrative parameters with measured data, select the fidelity required by the decision, and revalidate every extension before applying it to a real battery, converter, vehicle, or grid-storage system.
Direct questions
What should a new user know?
What is the MATLAB Simulink Energy Lab?
An open collection of inspectable battery and power-electronics models with visible assumptions, units, sign conventions, checks, and limits.
Which battery models are included?
First-order and two-RC electrical models, an SOC extended Kalman filter, coupled cell and module thermal models, and a pouch-cell through-thickness finite-volume model.
How is the lab validated?
Version 0.6.0 contains eleven base-MATLAB checks and four native Simulink checks, all verified on MATLAB R2026a.
Can the models qualify hardware?
No. They are transparent starting points. Cell-specific calibration, measured validation, safety analysis, tolerances, and project qualification remain necessary.