Simscape-Battery-Library

A Li-ion battery library written in Matlab Simscape language (Matlab 2023a). Battery library includes:

1. A thermally coupled Equivalent Circuit Model (first order) with look-up-tables for the parameters (TECM)
2. A thermally coupled Equivalent Circuit Model with Diffusion (TECMD)
3. A thermally coupled Single Particle Model with electrolyte (TSPMe)
4. A thermally coupled Single Particle Model with electrolyte and Ageing (TSPMeA). Ageing includes SEI growth, Li-plating and negative electrode porosity reduction.

• A few utility components to define the interface conditions with the battery models
  • a simple battery cycler with CCCV charging,
  • a general electrical source - I/V/P
  • a controlled electrical source - I/V/P)
• Two general purpose functions getVariables() and plotVaraibles() in the +Utilities folder. BatteryLibrary.Utilities.getVariables() will extract the relevant time and distributed variables of any of the Battery Library models and BatteryLibrary.Utilities.plotVaraibles() plots the signals. See "gettingStarted.mlx" in the "Examples\viaMatlabCode" directory on how to use these two functions.

Installation

• Clone (or download) the repository.
• Add the top level directory ("BatterySimscape_Library") in to the Matlab path (you can do this via the Matlab command >>addpath(path to BatterySimscape_Library)).
• Once added to the path, to start using the libarary componets from any location in Matlab, run the command >>BatteryLibrary_lib which will open the battery library and the blocks can be dragged into a Simulink template (.slx or .mdl) file

Usage

• See "simpleExamples" folder for running the models with utility components directly in Simulink
• See "viaMatlabCode" for examples that call the model to perform various simulations, e.g. Power discharge, Remaining Useful-Energy calculations, cycle ageing, etc
• A parameter estimation example of the TECMD model is also provided (can be a lot further improved, requires Simulink Design Optimisation Toolbox)

Dependencies

• Simulink Design Optimisation Toolbox is required for the parameter estimation example

Model references

The TSPMe and TSPMeA models are result of the following two papers done in collaboration with Ferran Brosa-Planella.

• TSPMe
• TSPMeA

The Parameters for the physcial models are from the work done in collaboration with University of Birmingham

• TSPMe parameters

The TECMD is a simplified version (only a single OCV + diffusion) of the work done in collaboration with Chuanxin Fan

• TECMD