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.
2 maintainers
Metadata
2 maintainers
Release files for simses 2.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| simses-2.1.1.tar.gz | 137.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simses-2.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 197.6 kB
Release files / simses-2.1.1.tar.gz
| Download URL | simses-2.1.1.tar.gz |
|---|---|
| Size | 137.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
17f6e678e7995901fde45f07654dbdb960b85c44464a00d66af6311c11728995
|
|
BLAKE2b-256 checksum How to use checksums |
95198b4e0879343d410c9c7c803fcb8bb1bc55c88e6f8623aaa2d4a50bec8101
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 17, 2026.
Transparency logRelease files / simses-2.1.1-py3-none-any.whl
| Download URL | simses-2.1.1-py3-none-any.whl |
|---|---|
| Size | 60.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab80fa076c075ad4942851fb6e7776aa359b249bf4ba680fa8c9148e7f163a72
|
|
BLAKE2b-256 checksum How to use checksums |
788be986e42d1f85cc6829042c209d7033b56cbf7c8f4a6b0094eafdc446a17c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 17, 2026.
Transparency log
