tsib - Time Series Initialization for Buildings

tsib is a python package that builds up on different databases and models for creating consistent demand and production time series of residential buildings. This could be either occupancy behavior, electricity demand or heat demand time series as well as photovoltaic (PV) and solar thermal production time series.

If you want to use tsib in a published work, please cite following publication which applies tsib for the creation of time series for residential buildings in Germany.

Features

• flexible configuration of single buildings by different input arguments
• simple building definition based on an archetype building catalogue
• consideration of the occupancy behavior
• derivation of the electric device load or the demand for thermal comfort
• calculation of the heat load based on a thermal building model
• provision of location specific time series for solar irradiation and temperature based on weather data

Applied databases and models

tsib is a flexible tool which allows the use of different models and databases for the generation of time series for buildings. In Version 0.1.0 the following databases and models are included is tsib:

• CREST demand model for the simulaton of the occupancy behavior
• 5R1C thermal building model
• pvlib for solar irradiance calculation and photovoltaic simulation
• TABULA/EPISCOPE archetype building catalogue
• DWD Testreferenzjahre for providing weather data

Installation

Directly install via pip as follows:

pip install tsib

Alternatively, clone a local copy of the repository to your computer

git clone https://github.com/FZJ-IEK3-VSA/tsib.git

Then install tsib via pip as follow

cd tsib
pip install . 

Or install directly via python as

python setup.py install

In order to use the 5R1C thermal building model, make sure that you have installed a MILP solver. As default solver coin-cbc is used which can either installed by

sudo apt-get install coinor-cbc

or for Anaconda under windows as

conda install -c conda-forge coincbc

. Other solvers can be defined by defining the environment variable $SOLVER.

To get flexible weather data from the Climate Data Store, register here and follow the instructions to get an own key. Make sure that you have agreed on the license terms.

Examples

This jupyter notebook shows the capabilites of tsib to create all relevant time series.

License

MIT License

Copyright (C) 2016-2022 Leander Kotzur (FZJ IEK-3), Timo Kannengießer (FZK-IEK-3), Kevin Knosala (FZJ IEK-3), Peter Stenzel (FZJ IEK-3), Peter Markewitz (FZJ IEK-3), Martin Robinius (FZJ IEK-3), Detlef Stolten (FZJ IEK-3)

You should have received a copy of the MIT License along with this program.
If not, see https://opensource.org/licenses/MIT

About Us

Acknowledgement

This work was supported by the Helmholtz Association under the Joint Initiative "Energy System 2050 A Contribution of the Research Field Energy".