Awesome
<a href="https://www.fz-juelich.de/en/iek/iek-3"><img src="https://raw.githubusercontent.com/OfficialCodexplosive/README_Assets/862a93188b61ab4dd0eebde3ab5daad636e129d5/FJZ_IEK-3_logo.svg" alt="FZJ Logo" width="300px"></a>
bslib - battery storage library
Repository with code to
- build a database with relevant data from PerMod database (HTW Berlin) and "Stromspeicher-Inspektion"
- simulate ac- and dc-coupled battery storages with regards to electrical power (ac and dc) and state-of-charge as timeseries.
For the simulation, it is possible to calculate outputs of a specific manufacturer + model or alternatively for one of 2 different generic battery storage types.
For reference purposes:
- DOI: https://doi.org/10.5281/zenodo.6514527
- Citation: Kai Rösken, Tjarko Tjaden, & Hauke Hoops. (2022). FZJ-IEK3-VSA/bslib: v0.7. Zenodo. https://doi.org/10.5281/zenodo.6514527
Documentation
The documentation is still under development.
Usage
Simply install via
pip install bslib
or clone repository and create environment via:
git clone https://github.com/FZJ-IEK3-VSA/bslib.git
conda env create --name bslib --file requirements.txt
Afterwards you're able to create some code with import bslib
and use the included functions load_database
, get_parameters
and simulate
.
Battery models and Group IDs
The bslib_database.csv contains the following number of battery storages, sorted by Group ID
[Group ID]: Count | Description |
---|---|
[S_ac]: 2 | AC-coupled |
[S_dc]: 3 | DC-coupled |
[INV]: 2 | PV Inverter |
Database
All resulting database CSV file are under .
The following columns are available for every battery storage of this library
Column | Description | Comment |
---|---|---|
.. | .. | .. |
Input-Data and further development
If you find errors or are interested in develop the bslib, please create an ISSUE and/or FORK this repository and create a PULL REQUEST.
License
MIT License
Copyright (c) 2022
You should have received a copy of the MIT License along with this program. If not, see https://opensource.org/licenses/MIT