simses 2.0.0

Add your description here

simses

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.

Installation

Requires Python 3.12+.

pip install simses

Development

We recommend uv for managing the development environment:

git clone https://github.com/tum-ees/simses.git
cd simses
uv sync

We use pytest for testing and ruff for linting and formatting:

uv run pytest

Citation

If 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

Acknowledgements

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.

License

See LICENSE.