simses is a Python simulator for battery energy storage systems (BESS). It models battery systems
with equivalent-circuit cells, AC/DC converters, thermal behavior, and aging — for researchers
and engineers working on storage applications, sizing studies, operating strategies, and
techno-economic analysis.
It is designed to be simple, modular, and composable: a lightweight core that is easy to read, extend, and integrate into your own simulations.
Full documentation: tum-ees.github.io/simses.
Requires Python 3.12+.
pip install simsesWe recommend uv for managing the development environment:
git clone https://github.com/tum-ees/simses.git
cd simses
uv syncWe use pytest for testing and ruff for linting and formatting:
uv run pytestIf you use simses in academic work, please cite the original SimSES paper:
Möller, M., Kucevic, D., Collath, N., Parlikar, A., Dotzauer, P., Tepe, B., Englberger, S., Jossen, A., & Hesse, H. (2022). SimSES: A holistic simulation framework for modeling and analyzing stationary energy storage systems. Journal of Energy Storage, 49, 103743. https://doi.org/10.1016/j.est.2021.103743
simses is a ground-up rewrite of the original
simses, developed at the Chair of Electrical Energy
Storage Technology (EES) at the Technical University of Munich. This version builds directly on the
models, data, and years of research from that project.
See LICENSE.