Skip to content

A Li-ion battery library written in Matlab Simscape language. Battery models include: TSPMeA, TSPMe, TECMD, TECM and a few utility components

License

Notifications You must be signed in to change notification settings

WDWidanage/Simscape-Battery-Library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simscape-Battery-Library Open in MATLAB Online View A Simscape-Battery-Library on File Exchange

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 plotVariables() 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.plotVariables() 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
  • You can also try all the examples online if you have a MathWorks account from here Open in MATLAB Online. Make sure to add the repo folder to the Matalb path online as well. You should have a folder called 'Simscape-Battery-Library', right click, go to 'Add to path' and select 'Selected Folder(s) and Subfolders'.

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.

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

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

About

A Li-ion battery library written in Matlab Simscape language. Battery models include: TSPMeA, TSPMe, TECMD, TECM and a few utility components

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages