[![Build Status](https://img.shields.io/gitlab/pipeline/l-kotzur/tsorb/master.svg)](https://gitlab.com/l-kotzur/tsorb/pipelines)
[![Version](https://img.shields.io/pypi/v/tsorb.svg)](https://pypi.python.org/pypi/tsorb)
<a href="https://www.fz-juelich.de/iek/iek-3/EN/Home/home_node.html"><img src="https://www.fz-juelich.de/SharedDocs/Bilder/INM/INM-1/EN/FZj_Logo.jpg?__blob=normal" alt="Forschungszentrum Juelich Logo" width="230px"></a>
# tsorb - Time Series of Occupants in Residential Buildings
*tsorb* is a python module derived from the first version of the CREST Demand Model [1,2,3]. It was updated with four state occupancy data [4] and validated for Germany [5]. It creates time series of occupancy activity and device load in residential buildings.
## Installation
Directly install via pip as follows:
pip install tsorb
Alternatively, clone a local copy of the repository to your computer
git clone https://github.com/FZJ-IEK3-VSA/tsorb.git
Then install tsorb via pip as follow
cd tsorb
pip install .
## License
Copyright (C) 2008, 2011 Ian Richardson*, Murray Thomson*, Eoghan McKenna*
2016 Nils Becker, 2018 Leander Kotzur**, Kevin Knosala**, Peter Stenzel**, Peter Markewitz**, Martin Robinius**, Detlef Stolten**
*CREST (Centre for Renewable Energy Systems Technology),
Department of Electronic and Electrical Engineering
Loughborough University, Leicestershire LE11 3TU, UK
** Institute of Techno-economic Systems Analysis (IEK-3), Forschungszentrum Jueulich GmbH, Wilhelm-Johnen-Str., 52428 Juelich, Germany
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
## References
[1] Richardson, I., Thomson, M., and Infield, D. A high-resolution domestic building occupancy model for energy demand simulations. Energy and Buildings, 40(8):1560–1566, 2008. ISSN 03787788. doi: 10.1016/j.enbuild.2008.02.006.
[2] Richardson, I., Thomson, M., Infield, D., and Delahunty, A. Domestic lighting: A high-resolution energy demand model. Energy and Buildings, 41(7):781–789, 2009. ISSN 03787788. doi: 10.1016/j.enbuild.2009.02.010.
[3] Richardson, I., Thomson, M., Infield, D., and Clifford, C. Domestic electricity use: A high-resolution energy demand model. Energy and Buildings, 42(10):1878–1887, 2010. ISSN 03787788. doi: 10.1016/j.enbuild.2010.05.023.
[4] McKenna, E. and Thomson, M. High-resolution stochastic integrated thermal–electrical domestic demand model. Applied Energy, 165:445–461, 2016.ISSN 03062619. doi: 10.1016/j.apenergy.2015.12.089.
[5] Kotzur, L. [Future grid load of the residential building sector](http://juser.fz-juelich.de/record/858675). Thesis, 2018. isbn: 978-3-95806-370-9,
Raw data
{
"_id": null,
"home_page": "https://github.com/FZJ-IEK3-VSA/tsorb",
"name": "tsorb",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "residential buildings,electricity load,occupancy behavior,markov chain",
"author": "Forschungszentrum Juelich GmbH",
"author_email": "l.kotzur@fz-juelich.de",
"download_url": "https://files.pythonhosted.org/packages/e8/47/0766550b3599cb7fdb7ee5b8bc75e99266783c5f2d43af35e5e54cd0c0cf/tsorb-0.0.3.tar.gz",
"platform": null,
"description": "[![Build Status](https://img.shields.io/gitlab/pipeline/l-kotzur/tsorb/master.svg)](https://gitlab.com/l-kotzur/tsorb/pipelines)\n[![Version](https://img.shields.io/pypi/v/tsorb.svg)](https://pypi.python.org/pypi/tsorb)\n\n\n<a href=\"https://www.fz-juelich.de/iek/iek-3/EN/Home/home_node.html\"><img src=\"https://www.fz-juelich.de/SharedDocs/Bilder/INM/INM-1/EN/FZj_Logo.jpg?__blob=normal\" alt=\"Forschungszentrum Juelich Logo\" width=\"230px\"></a> \n\n\n# tsorb - Time Series of Occupants in Residential Buildings \n\n*tsorb* is a python module derived from the first version of the CREST Demand Model [1,2,3]. It was updated with four state occupancy data [4] and validated for Germany [5]. It creates time series of occupancy activity and device load in residential buildings.\n\n## Installation\nDirectly install via pip as follows:\n\n\tpip install tsorb\n\nAlternatively, clone a local copy of the repository to your computer\n\n\tgit clone https://github.com/FZJ-IEK3-VSA/tsorb.git\n\t\nThen install tsorb via pip as follow\n\t\n\tcd tsorb\n\tpip install . \n\n\n## License\n\nCopyright (C) 2008, 2011 Ian Richardson*, Murray Thomson*, Eoghan McKenna*\n 2016 Nils Becker, 2018 Leander Kotzur**, Kevin Knosala**, Peter Stenzel**, Peter Markewitz**, Martin Robinius**, Detlef Stolten**\n\n *CREST (Centre for Renewable Energy Systems Technology),\n Department of Electronic and Electrical Engineering\n Loughborough University, Leicestershire LE11 3TU, UK\n\n ** Institute of Techno-economic Systems Analysis (IEK-3), Forschungszentrum Jueulich GmbH, Wilhelm-Johnen-Str., 52428 Juelich, Germany\n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see <http://www.gnu.org/licenses/>.\n\n\n## References\n\n[1] Richardson, I., Thomson, M., and Infield, D. A high-resolution domestic building occupancy model for energy demand simulations. Energy and Buildings, 40(8):1560\u20131566, 2008. ISSN 03787788. doi: 10.1016/j.enbuild.2008.02.006.\n\n[2] Richardson, I., Thomson, M., Infield, D., and Delahunty, A. Domestic lighting: A high-resolution energy demand model. Energy and Buildings, 41(7):781\u2013789, 2009. ISSN 03787788. doi: 10.1016/j.enbuild.2009.02.010.\n\n[3] Richardson, I., Thomson, M., Infield, D., and Clifford, C. Domestic electricity use: A high-resolution energy demand model. Energy and Buildings, 42(10):1878\u20131887, 2010. ISSN 03787788. doi: 10.1016/j.enbuild.2010.05.023.\n\n[4] McKenna, E. and Thomson, M. High-resolution stochastic integrated thermal\u2013electrical domestic demand model. Applied Energy, 165:445\u2013461, 2016.ISSN 03062619. doi: 10.1016/j.apenergy.2015.12.089.\n\n[5] Kotzur, L. [Future grid load of the residential building sector](http://juser.fz-juelich.de/record/858675). Thesis, 2018. isbn: 978-3-95806-370-9,",
"bugtrack_url": null,
"license": "",
"summary": "Time Series of Occupants in Residential Buildings",
"version": "0.0.3",
"split_keywords": [
"residential buildings",
"electricity load",
"occupancy behavior",
"markov chain"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e8470766550b3599cb7fdb7ee5b8bc75e99266783c5f2d43af35e5e54cd0c0cf",
"md5": "692b0f2a2c8773e9cd1f1e6cbeddfdfa",
"sha256": "ae1bcfff5bc2475cde3439560ceadb3b449973c8fa9ecc2abf81a411c5f7c9f2"
},
"downloads": -1,
"filename": "tsorb-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "692b0f2a2c8773e9cd1f1e6cbeddfdfa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1304549,
"upload_time": "2023-03-22T09:46:16",
"upload_time_iso_8601": "2023-03-22T09:46:16.621638Z",
"url": "https://files.pythonhosted.org/packages/e8/47/0766550b3599cb7fdb7ee5b8bc75e99266783c5f2d43af35e5e54cd0c0cf/tsorb-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-22 09:46:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "FZJ-IEK3-VSA",
"github_project": "tsorb",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "tsorb"
}