https://github.com/FZJ-IEK3-VSA/bslib

Database with battery parameters based on PerMod (HTW Berlin) as well as functions in order to simulate battery storages (manufacturer+model or generic type)
https://github.com/FZJ-IEK3-VSA/bslib

battery energy simulation

Last synced: about 2 months ago
JSON representation

Database with battery parameters based on PerMod (HTW Berlin) as well as functions in order to simulate battery storages (manufacturer+model or generic type)

• Host: GitHub
• URL: https://github.com/FZJ-IEK3-VSA/bslib
• Owner: FZJ-IEK3-VSA
• License: mit
• Created: 2021-09-22T13:32:40.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-01-18T07:46:55.000Z (almost 2 years ago)
• Last Synced: 2024-06-11T20:43:47.598Z (7 months ago)
• Topics: battery, energy, simulation
• Language: Python
• Homepage:
• Size: 919 KB
• Stars: 9
• Watchers: 5
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• open-sustainable-technology - bslib - Database with battery parameters based on PerMod as well as functions in order to simulate battery storages. (Energy Storage / Battery)

README

        
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.6514527.svg)](https://doi.org/10.5281/zenodo.6514527)



# 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 [![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/).

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

## About Us



We are the Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3) belonging to the Forschungszentrum Jülich. Our interdisciplinary department's research is focusing on energy-related process and systems analyses. Data searches and system simulations are used to determine energy and mass balances, as well as to evaluate performance, emissions and costs of energy systems. The results are used for performing comparative assessment studies between the various systems. Our current priorities include the development of energy strategies, in accordance with the German Federal Government’s greenhouse gas reduction targets, by designing new infrastructures for sustainable and secure energy supply chains and by conducting cost analysis studies for integrating new technologies into future energy market frameworks.