[](https://gitlab.com/l-kotzur/tsib/pipelines)
[](https://pypi.python.org/pypi/tsib)
<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>
# 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**](http://juser.fz-juelich.de/record/858675) 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](https://www.lboro.ac.uk/research/crest/demand-model/) demand model for the simulaton of the occupancy behavior
* [5R1C](https://www.sciencedirect.com/science/article/abs/pii/S0306261916314933) thermal building model
* [pvlib](https://github.com/pvlib/pvlib-python) for solar irradiance calculation and photovoltaic simulation
* [TABULA/EPISCOPE](http://episcope.eu/) archetype building catalogue
* [DWD Testreferenzjahre](https://www.dwd.de/DE/leistungen/testreferenzjahre/testreferenzjahre.html) 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](https://cds.climate.copernicus.eu/api-how-to) and follow the instructions to get an own key. Make sure that you have agreed on the [license terms](https://cds.climate.copernicus.eu/cdsapp/#!/terms/licence-to-use-copernicus-products).
## Examples
This [jupyter notebook](examples/showcase.ipynb) 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
<p align="center"><a href="https://www.fz-juelich.de/en/iek/iek-3"><img src="https://github.com/OfficialCodexplosive/README_Assets/blob/master/iek3-wide.png?raw=true" alt="Institut TSA"></a></p>
We are the <a href="https://www.fz-juelich.de/en/iek/iek-3">Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3)</a> belonging to the <a href="https://www.fz-juelich.de/en">Forschungszentrum Jülich</a>. 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.
## Acknowledgement
This work was supported by the Helmholtz Association under the Joint Initiative ["Energy System 2050 A Contribution of the Research Field Energy"](https://www.helmholtz.de/en/research/energy/energy_system_2050/).
<a href="https://www.helmholtz.de/en/"><img src="https://www.helmholtz.de/fileadmin/user_upload/05_aktuelles/Marke_Design/logos/HG_LOGO_S_ENG_RGB.jpg" alt="Helmholtz Logo" width="200px" style="float:right"></a>
Raw data
{
"_id": null,
"home_page": "https://github.com/FZJ-IEK3-VSA/tsib",
"name": "tsib",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "buildings,thermal load,electricity load,optimization",
"author": "Leander Kotzur",
"author_email": "l.kotzur@fz-juelich.de",
"download_url": "https://files.pythonhosted.org/packages/a9/46/aa854beb050c31f1f2d32aeaf8f59f9b6ce6d30857c78d9b532cbf0c65e1/tsib-0.1.6.tar.gz",
"platform": null,
"description": "[](https://gitlab.com/l-kotzur/tsib/pipelines)\n[](https://pypi.python.org/pypi/tsib)\n\n<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>\n\n# tsib - Time Series Initialization for Buildings\n\ntsib 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.\n\n\nIf you want to use tsib in a published work, please [**cite following publication**](http://juser.fz-juelich.de/record/858675) which applies tsib for the creation of time series for residential buildings in Germany. \n\n\n## Features\n* flexible configuration of single buildings by different input arguments\n* simple building definition based on an archetype building catalogue\n* consideration of the occupancy behavior\n* derivation of the electric device load or the demand for thermal comfort\n* calculation of the heat load based on a thermal building model\n* provision of location specific time series for solar irradiation and temperature based on weather data\n\n\n## Applied databases and models\ntsib 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:\n* [CREST](https://www.lboro.ac.uk/research/crest/demand-model/) demand model for the simulaton of the occupancy behavior\n* [5R1C](https://www.sciencedirect.com/science/article/abs/pii/S0306261916314933) thermal building model \n* [pvlib](https://github.com/pvlib/pvlib-python) for solar irradiance calculation and photovoltaic simulation\n* [TABULA/EPISCOPE](http://episcope.eu/) archetype building catalogue\n* [DWD Testreferenzjahre](https://www.dwd.de/DE/leistungen/testreferenzjahre/testreferenzjahre.html) for providing weather data\n\n\n## Installation\nDirectly install via pip as follows:\n\n\tpip install tsib\n\nAlternatively, clone a local copy of the repository to your computer\n\n\tgit clone https://github.com/FZJ-IEK3-VSA/tsib.git\n\t\nThen install tsib via pip as follow\n\t\n\tcd tsib\n\tpip install . \n\t\nOr install directly via python as \n\n\tpython setup.py install\n\t\nIn 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\n\n\tsudo apt-get install coinor-cbc\n\nor for Anaconda under windows as\n\n\tconda install -c conda-forge coincbc\n\n. Other solvers can be defined by defining the environment variable $SOLVER. \n\t\nTo get flexible weather data from the Climate Data Store, register [here](https://cds.climate.copernicus.eu/api-how-to) and follow the instructions to get an own key. Make sure that you have agreed on the [license terms](https://cds.climate.copernicus.eu/cdsapp/#!/terms/licence-to-use-copernicus-products).\n\n\t\n## Examples\n\nThis [jupyter notebook](examples/showcase.ipynb) shows the capabilites of tsib to create all relevant time series. \n\n\n## License\n\nMIT License\n\nCopyright (C) 2016-2022 Leander Kotzur (FZJ IEK-3), Timo Kannengie\u00dfer (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)\n\nYou should have received a copy of the MIT License along with this program.\nIf not, see https://opensource.org/licenses/MIT\n\n## About Us\n<p align=\"center\"><a href=\"https://www.fz-juelich.de/en/iek/iek-3\"><img src=\"https://github.com/OfficialCodexplosive/README_Assets/blob/master/iek3-wide.png?raw=true\" alt=\"Institut TSA\"></a></p>\nWe are the <a href=\"https://www.fz-juelich.de/en/iek/iek-3\">Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3)</a> belonging to the <a href=\"https://www.fz-juelich.de/en\">Forschungszentrum J\u00fclich</a>. 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\u2019s 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.\n\n## Acknowledgement\n\nThis work was supported by the Helmholtz Association under the Joint Initiative [\"Energy System 2050 A Contribution of the Research Field Energy\"](https://www.helmholtz.de/en/research/energy/energy_system_2050/).\n\n<a href=\"https://www.helmholtz.de/en/\"><img src=\"https://www.helmholtz.de/fileadmin/user_upload/05_aktuelles/Marke_Design/logos/HG_LOGO_S_ENG_RGB.jpg\" alt=\"Helmholtz Logo\" width=\"200px\" style=\"float:right\"></a>",
"bugtrack_url": null,
"license": "",
"summary": "Time Series Initialization for Buildings",
"version": "0.1.6",
"split_keywords": [
"buildings",
"thermal load",
"electricity load",
"optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a946aa854beb050c31f1f2d32aeaf8f59f9b6ce6d30857c78d9b532cbf0c65e1",
"md5": "901995b22647651b5c42152cfbb3b683",
"sha256": "5f5b58c14b7957e384c82eaf9068649c116d6b3ab2055ab173e0d0c33f8fc41d"
},
"downloads": -1,
"filename": "tsib-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "901995b22647651b5c42152cfbb3b683",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4365487,
"upload_time": "2023-03-22T09:31:50",
"upload_time_iso_8601": "2023-03-22T09:31:50.511773Z",
"url": "https://files.pythonhosted.org/packages/a9/46/aa854beb050c31f1f2d32aeaf8f59f9b6ce6d30857c78d9b532cbf0c65e1/tsib-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-22 09:31:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "FZJ-IEK3-VSA",
"github_project": "tsib",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "tsib"
}
JSON
