mohammadrezwankhan/matlab-simulink-energy-lab

MATLAB Simulink Energy Lab is a growing collection of small, runnable examples for learning how battery and power-converter systems behave, aimed at students, researchers, and hobbyists. Each example is a self-contained MATLAB model with built-in checks so you can see whether it is working correctly, and every parameter and assumption behind the math is meant to be traceable rather than hidden. The examples cover several related topics. There are battery models that simulate how terminal voltage and state of charge change during charge and discharge pulses, starting with a simple first-order model and moving up to a two-branch model that separates fast and slow internal polarization effects. A thermal model builds on this by tracking how electrical losses and heat generated inside the battery raise or lower its temperature over time, and how that temperature feeds back into resistance. Several of these battery models also have native Simulink block-diagram versions that are checked against the plain script versions to confirm they behave the same way. On the power-electronics side, the repository includes models of an averaged buck converter, meaning a simplified model of a circuit that steps voltage down, along with a closed-loop version that compares open-loop, PI, and filtered-PID control strategies for handling sudden load changes, and a switching-level model that compares ideal pulse-width-modulated waveforms against the averaged estimates. To try it, you clone the repository and run a batch of MATLAB check scripts, seven of which only need base MATLAB while four also require Simulink. Running these produces printed output confirming state of charge, voltage ranges, temperatures, and controller performance numbers, which you can compare against the expected results shown in the README. The project has GitHub Actions set up to automatically rerun these validation checks whenever the model code changes, and it is released under the MIT license.