[](https://pypi.python.org/pypi/pyloadprofilegenerator)
[](LICENSE)
# pyLPG
This package provides bindings and binaries to execute the [LoadProfileGenerator](https://www.loadprofilegenerator.de/) (LPG) from python.
Basically it
* converts your settings into a JSON file for the LPG that specifies what the LPG should calculate,
* starts the binary depending on your platform (Windows/Linux),
* waits for the results,
* and then returns the results as pandas dataframe.
Look into the [single household example](examples/single_household.py) for a simple example on use.
Example of a generated electricity load profile as a carpet plot:
<a href=examples/example_carpet_plot.png><img src="examples/example_carpet_plot.png" alt="electric load carpet plot" width="500px"></a>
Note that this package downloads the full LPG binaries and the database on first use.
If you want to use a different database than the one that comes with the package, you need to replace the files.
## Installation
This package can be installed via pip:
pip install pyloadprofilegenerator
## License
MIT License
Copyright (C) 2022 Noah Pflugradt (FZJ IEK-3), David Neuroth (FZJ IEK-3), Peter Stenzel (FZJ IEK-3), Leander Kotzur (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
## Citing
If you use pylpg in a published work, please cite:
Noah Pflugradt, Peter Stenzel, Leander Kotzur, and Detlef Stolten (2022). LoadProfileGenerator: An Agent-Based Behavior Simulation for Generating Residential Load Profiles. Journal of Open Source Software, 7(71), 3574, https://doi.org/10.21105/joss.03574
## About Us
The package is mainted by the [Institute of Energy and Climate Research – Techno-Economic Systems Analysis (IEK-3)](https://www.fz-juelich.de/en/iek/iek-3) belonging to the [Forschungszentrum Jülich](https://www.fz-juelich.de/).
## Contributing
We need your help to make pyLPG an even better tool than it is. Please raise an issue, if it is not clear how to use the package, if you find a bug, or if you have an idea how to improve. If you have implemented a solution, you are invited to contribute with a pull request.
<a href="https://www.fz-juelich.de/en/iek/iek-3"><img src="https://www.fz-juelich.de/static/media/Logo.2ceb35fc.svg" alt="Forschungszentrum Juelich Logo" width="230px"></a>
Raw data
{
"_id": null,
"home_page": "https://github.com/FZJ-IEK3-VSA/pylpg",
"name": "pyloadprofilegenerator",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "buildings, thermal load, electricity load",
"author": "Noah Pflugradt",
"author_email": "n.pflugradt@fz-juelich.de",
"download_url": "https://files.pythonhosted.org/packages/20/46/25babba4ae4cf30618a2c9e1a37ec7f4b44630ae791a0377b2a44f12aa3f/pyloadprofilegenerator-0.1.1.tar.gz",
"platform": null,
"description": " [](https://pypi.python.org/pypi/pyloadprofilegenerator)\r\n [](LICENSE)\r\n\r\n# pyLPG\r\n\r\nThis package provides bindings and binaries to execute the [LoadProfileGenerator](https://www.loadprofilegenerator.de/) (LPG) from python.\r\n\r\nBasically it \r\n* converts your settings into a JSON file for the LPG that specifies what the LPG should calculate,\r\n* starts the binary depending on your platform (Windows/Linux), \r\n* waits for the results,\r\n* and then returns the results as pandas dataframe.\r\n\r\nLook into the [single household example](examples/single_household.py) for a simple example on use.\r\n\r\nExample of a generated electricity load profile as a carpet plot:\r\n\r\n<a href=examples/example_carpet_plot.png><img src=\"examples/example_carpet_plot.png\" alt=\"electric load carpet plot\" width=\"500px\"></a> \r\n\r\nNote that this package downloads the full LPG binaries and the database on first use.\r\n\r\nIf you want to use a different database than the one that comes with the package, you need to replace the files.\r\n\r\n## Installation\r\n\r\nThis package can be installed via pip:\r\n\r\n pip install pyloadprofilegenerator\r\n\r\n## License\r\n\r\nMIT License\r\n\r\nCopyright (C) 2022 Noah Pflugradt (FZJ IEK-3), David Neuroth (FZJ IEK-3), Peter Stenzel (FZJ IEK-3), Leander Kotzur (FZJ IEK-3), Detlef Stolten (FZJ IEK-3)\r\n\r\nYou should have received a copy of the MIT License along with this program.\r\nIf not, see https://opensource.org/licenses/MIT\r\n\r\n## Citing\r\n\r\nIf you use pylpg in a published work, please cite:\r\n\r\nNoah Pflugradt, Peter Stenzel, Leander Kotzur, and Detlef Stolten (2022). LoadProfileGenerator: An Agent-Based Behavior Simulation for Generating Residential Load Profiles. Journal of Open Source Software, 7(71), 3574, https://doi.org/10.21105/joss.03574\r\n\r\n## About Us \r\n\r\nThe package is mainted by the [Institute of Energy and Climate Research \u00e2\u20ac\u201c Techno-Economic Systems Analysis (IEK-3)](https://www.fz-juelich.de/en/iek/iek-3) belonging to the [Forschungszentrum J\u00c3\u00bclich](https://www.fz-juelich.de/). \r\n\r\n\r\n## Contributing\r\n\r\nWe need your help to make pyLPG an even better tool than it is. Please raise an issue, if it is not clear how to use the package, if you find a bug, or if you have an idea how to improve. If you have implemented a solution, you are invited to contribute with a pull request.\r\n\r\n<a href=\"https://www.fz-juelich.de/en/iek/iek-3\"><img src=\"https://www.fz-juelich.de/static/media/Logo.2ceb35fc.svg\" alt=\"Forschungszentrum Juelich Logo\" width=\"230px\"></a> \r\n",
"bugtrack_url": null,
"license": null,
"summary": "Python Bindings for the LoadProfileGenerator",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/FZJ-IEK3-VSA/pylpg"
},
"split_keywords": [
"buildings",
" thermal load",
" electricity load"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c3ac2d4a9f152f8dbd2d629113e8ecf49522dbe810e67143b0e677b84f01826c",
"md5": "c0c2c1142d18d9a9c454046a087ff6df",
"sha256": "21ba81be1fc8cf9f266db5bc8fd21988bffa6bd69fafa7346bdf74b144e6ec05"
},
"downloads": -1,
"filename": "pyloadprofilegenerator-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c0c2c1142d18d9a9c454046a087ff6df",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 31561,
"upload_time": "2024-10-31T16:36:17",
"upload_time_iso_8601": "2024-10-31T16:36:17.770563Z",
"url": "https://files.pythonhosted.org/packages/c3/ac/2d4a9f152f8dbd2d629113e8ecf49522dbe810e67143b0e677b84f01826c/pyloadprofilegenerator-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "204625babba4ae4cf30618a2c9e1a37ec7f4b44630ae791a0377b2a44f12aa3f",
"md5": "5d01016bd3c05ca4598f3657c522fccb",
"sha256": "f09a4a4d4e123b1a04f329f9e4dd517854c2d7e672514705b32dee65603f78a2"
},
"downloads": -1,
"filename": "pyloadprofilegenerator-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "5d01016bd3c05ca4598f3657c522fccb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 102390,
"upload_time": "2024-10-31T16:36:18",
"upload_time_iso_8601": "2024-10-31T16:36:18.996077Z",
"url": "https://files.pythonhosted.org/packages/20/46/25babba4ae4cf30618a2c9e1a37ec7f4b44630ae791a0377b2a44f12aa3f/pyloadprofilegenerator-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-31 16:36:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FZJ-IEK3-VSA",
"github_project": "pylpg",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pyloadprofilegenerator"
}
JSON
