This repository serves as a personal self-study initiative aimed at deepening my understanding of lithium-ion battery management systems. Through this project, I aim to gain practical experience in exploring SOC and SOH estimation techniques while identifying areas for self-improvement in my own knowledge and skills. It is designed more so as a sandbox for me to develop, test and implement state estimation techniques for various sample li-ion batteries.
- Learn: Gain knowledge about simple SOX estimatino techniques, and branch towards more sophisticated SOC estimation techniques, such as Extended Kalman Filters or machine learning-based approaches.
- Account for Real Life: Explore how to work with real-world battery datasets with variable quality to validate models and improve accuracy.
- KPIs: Understand key performance indicators for BMS, including efficiency and reliability metrics.
- Avoid obsolence: Testing either recent software solutions or published theories from papers to calibrate understanding to latest global view.
This project is organized into several directories, each serving a specific purpose:
battery-state-estimation/
├── datasets/ # Directory for storing datasets (autopopulated after running nb)
├── models/ # Contains modules for SOC and SOH estimation
├── utils/ # Utility functions for data generation and processing
├── notebooks/ # Jupyter notebooks for interactive exploration
│ └── soc_est_comparisons.ipynb # Main notebook for testing and visualization
├── README.md # Project overview and documentation
└── requirements.txt # List of dependencies required to run the project
To run this project, you will need Python installed on your machine along with the required libraries. Current version utilizations neing utilzied locally are as follows:
- Python (3.11.7)
- Virtual environment created using Python 3.11 (Not required but suggested)
Otherwise, you can install the dependencies using the following command:
pip install -r requirements.txt
Models built on TensorFlow and modeled on datasets LG 18650HG2 and Panasonic 18650PF.