Thermal Engineering Systems in Python
=====================================
TESPy stands for "Thermal Engineering Systems in Python" and provides a
powerful simulation toolkit for thermal engineering plants such as power
plants, district heating systems or heat pumps. It is an external extension
module within the `Open Energy Modelling Framework <https://oemof.org/>`_ and
can be used as a standalone package.
.. figure:: https://raw.githubusercontent.com/oemof/tespy/9915f013c40fe418947a6e4c1fd0cd0eba45893c/docs/api/_images/logo_tespy_big.svg
:align: center
With the TESPy package you are able to calculate stationary operation in order
to design the process of thermal energy systems. From that point it is possible
to simulate the offdesign behavior of your plant using underlying
characteristics for each of the plants components. The package includes basic
components, such as turbines, pumps, compressors, heat exchangers, pipes,
mixers and splitters as well as some advanced components (derivatives of heat
exchangers, drum).
Everybody is welcome to use and/or develop TESPy. Contribution is already
possible on a low level by simply fixing typos in TESPy's documentation or
rephrasing sections which are unclear. If you want to support us that way
please fork the TESPy repository to your own github account and make changes
as described in the github guidelines:
https://guides.github.com/activities/hello-world/
Key Features
============
* **Open** Source
* **Generic** thermal engineering applications
* **Automatic** model documentation in LaTeX for high transparency and
reproducibility
* **Extendable** framework for the implementation of custom components and
component groups
* **Postprocessing** features like exergy analysis and fluid property plotting
Documentation
=============
You can find the full documentation at
`readthedocs <http://tespy.readthedocs.org>`_. Use the
`project site <http://readthedocs.org/projects/tespy>`_ of readthedocs to
choose the version of the documentation. Go to the
`download page <http://readthedocs.org/projects/tespy/downloads/>`_ to
download different versions and formats (pdf, html, epub) of the documentation.
To get the latest news visit and follow our `website <https://www.oemof.org>`_.
Installing TESPy
================
If you have a working Python3 environment, use pypi to install the latest
tespy version:
.. code:: bash
pip install tespy
If you want to use the latest features, you might want to install the
**developer version**. See section
`Developing TESPy <http://tespy.readthedocs.io/en/dev/development/how.html>`_
for more information. The developer version is not recommended for productive
use.
Get in touch
============
Online "Stammtisch"
-------------------
We have decided to start a reoccurring "Stammtisch" meeting for all interested
TESPy users and (potential) developers. You are invited to join us on every 3rd
Monday of a month at 17:00 CE(S)T for a casual get together. The first meeting
will be held at June, 20, 2022. The intent of this meeting is to establish a
more active and well connected network of TESPy users and developers.
If you are interested, you can simply join the meeting at
https://meet.jit.si/tespy_user_meeting. We are looking forward to seeing you!
User forum
----------
We have implemented a
`discussion room on GitHub <https://github.com/oemof/tespy/discussions>`__ as
user forum. If you have issues with setting up your model or any other question
about using the software, you are invited to start a discussion there.
Examples
========
For a short introduction on how TESPy works and how you can use it, we provide
an extensive `user guide <https://tespy.readthedocs.io/en/main/>`__. You can
download all python scripts of the examples and tutorials from this GitHub
repository. They are included in the "tutorial" directory.
Citation
========
The scope and functionalities of TESPy have been documented in a paper
published in the Journal of Open Source Software with an OpenAccess license.
Download the paper from https://doi.org/10.21105/joss.02178. As TESPy is a free
software, we kindly ask that you add a reference to TESPy if you use the
software for your scientific work. Please cite the article with the BibTeX
citation below.
BibTeX citation::
@article{Witte2020,
doi = {10.21105/joss.02178},
year = {2020},
publisher = {The Open Journal},
volume = {5},
number = {49},
pages = {2178},
author = {Francesco Witte and Ilja Tuschy},
title = {{TESPy}: {T}hermal {E}ngineering {S}ystems in {P}ython},
journal = {Journal of Open Source Software}
}
Furthermore, a paper on the exergy analysis feature has been published in
the mdpi journal energies. You can download the pdf at
https://doi.org/10.3390/en15114087. If you are using this feature specifically,
you can reference it with the following BibTeX citation:
BibTeX citation::
@article{Witte2022,
doi = {10.3390/en15114087},
year = {2022},
publisher = {The Open Journal},
volume = {15},
number = {11},
article-number = {4087},
issn = {1996-1073},
author = {Witte, Francesco and Hofmann, Mathias and Meier, Julius and Tuschy, Ilja and Tsatsaronis, George},
title = {Generic and Open-Source Exergy Analysis—Extending the Simulation Framework TESPy},
journal = {Energies}
}
Additionally, you have the possibility to cite a specific version of TESPy to
make your work reproducible. The source code of every version is published on
zenodo. Find your version here: https://doi.org/10.5281/zenodo.2555866.
License
=======
Copyright (c) 2017-2022 oemof developer group
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Raw data
{
"_id": null,
"home_page": "https://github.com/oemof/tespy",
"name": "TESPy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Francesco Witte",
"author_email": "tespy@witte.sh",
"download_url": "https://files.pythonhosted.org/packages/9f/c3/f3f189e7e24b0f3c2deeaf57c87ac07e1adb759b70c210f01a99170aaeb3/TESPy-0.6.3.tar.gz",
"platform": null,
"description": "Thermal Engineering Systems in Python\n=====================================\nTESPy stands for \"Thermal Engineering Systems in Python\" and provides a\npowerful simulation toolkit for thermal engineering plants such as power\nplants, district heating systems or heat pumps. It is an external extension\nmodule within the `Open Energy Modelling Framework <https://oemof.org/>`_ and\ncan be used as a standalone package.\n\n.. figure:: https://raw.githubusercontent.com/oemof/tespy/9915f013c40fe418947a6e4c1fd0cd0eba45893c/docs/api/_images/logo_tespy_big.svg\n :align: center\n\nWith the TESPy package you are able to calculate stationary operation in order\nto design the process of thermal energy systems. From that point it is possible\nto simulate the offdesign behavior of your plant using underlying\ncharacteristics for each of the plants components. The package includes basic\ncomponents, such as turbines, pumps, compressors, heat exchangers, pipes,\nmixers and splitters as well as some advanced components (derivatives of heat\nexchangers, drum).\n\nEverybody is welcome to use and/or develop TESPy. Contribution is already\npossible on a low level by simply fixing typos in TESPy's documentation or\nrephrasing sections which are unclear. If you want to support us that way\nplease fork the TESPy repository to your own github account and make changes\nas described in the github guidelines:\nhttps://guides.github.com/activities/hello-world/\n\nKey Features\n============\n* **Open** Source\n* **Generic** thermal engineering applications\n* **Automatic** model documentation in LaTeX for high transparency and\n reproducibility\n* **Extendable** framework for the implementation of custom components and\n component groups\n* **Postprocessing** features like exergy analysis and fluid property plotting\n\n\n\nDocumentation\n=============\nYou can find the full documentation at\n`readthedocs <http://tespy.readthedocs.org>`_. Use the\n`project site <http://readthedocs.org/projects/tespy>`_ of readthedocs to\nchoose the version of the documentation. Go to the\n`download page <http://readthedocs.org/projects/tespy/downloads/>`_ to\ndownload different versions and formats (pdf, html, epub) of the documentation.\n\nTo get the latest news visit and follow our `website <https://www.oemof.org>`_.\n\nInstalling TESPy\n================\nIf you have a working Python3 environment, use pypi to install the latest\ntespy version:\n\n.. code:: bash\n\n pip install tespy\n\nIf you want to use the latest features, you might want to install the\n**developer version**. See section\n`Developing TESPy <http://tespy.readthedocs.io/en/dev/development/how.html>`_\nfor more information. The developer version is not recommended for productive\nuse.\n\nGet in touch\n============\n\nOnline \"Stammtisch\"\n-------------------\n\nWe have decided to start a reoccurring \"Stammtisch\" meeting for all interested\nTESPy users and (potential) developers. You are invited to join us on every 3rd\nMonday of a month at 17:00 CE(S)T for a casual get together. The first meeting\nwill be held at June, 20, 2022. The intent of this meeting is to establish a\nmore active and well connected network of TESPy users and developers.\n\nIf you are interested, you can simply join the meeting at\nhttps://meet.jit.si/tespy_user_meeting. We are looking forward to seeing you!\n\nUser forum\n----------\nWe have implemented a\n`discussion room on GitHub <https://github.com/oemof/tespy/discussions>`__ as\nuser forum. If you have issues with setting up your model or any other question\nabout using the software, you are invited to start a discussion there.\n\nExamples\n========\n\nFor a short introduction on how TESPy works and how you can use it, we provide\nan extensive `user guide <https://tespy.readthedocs.io/en/main/>`__. You can\ndownload all python scripts of the examples and tutorials from this GitHub\nrepository. They are included in the \"tutorial\" directory.\n\nCitation\n========\nThe scope and functionalities of TESPy have been documented in a paper\npublished in the Journal of Open Source Software with an OpenAccess license.\nDownload the paper from https://doi.org/10.21105/joss.02178. As TESPy is a free\nsoftware, we kindly ask that you add a reference to TESPy if you use the\nsoftware for your scientific work. Please cite the article with the BibTeX\ncitation below.\n\nBibTeX citation::\n\n @article{Witte2020,\n doi = {10.21105/joss.02178},\n year = {2020},\n publisher = {The Open Journal},\n volume = {5},\n number = {49},\n pages = {2178},\n author = {Francesco Witte and Ilja Tuschy},\n title = {{TESPy}: {T}hermal {E}ngineering {S}ystems in {P}ython},\n journal = {Journal of Open Source Software}\n }\n\nFurthermore, a paper on the exergy analysis feature has been published in\nthe mdpi journal energies. You can download the pdf at\nhttps://doi.org/10.3390/en15114087. If you are using this feature specifically,\nyou can reference it with the following BibTeX citation:\n\nBibTeX citation::\n\n @article{Witte2022,\n doi = {10.3390/en15114087},\n year = {2022},\n publisher = {The Open Journal},\n volume = {15},\n number = {11},\n article-number = {4087},\n issn = {1996-1073},\n author = {Witte, Francesco and Hofmann, Mathias and Meier, Julius and Tuschy, Ilja and Tsatsaronis, George},\n title = {Generic and Open-Source Exergy Analysis—Extending the Simulation Framework TESPy},\n journal = {Energies}\n }\n\n\nAdditionally, you have the possibility to cite a specific version of TESPy to\nmake your work reproducible. The source code of every version is published on\nzenodo. Find your version here: https://doi.org/10.5281/zenodo.2555866.\n\nLicense\n=======\nCopyright (c) 2017-2022 oemof developer group\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Thermal Engineering Systems in Python (TESPy)",
"version": "0.6.3",
"project_urls": {
"Changelog": "https://tespy.readthedocs.io/en/main/whats_new.html",
"Documentation": "https://tespy.readthedocs.io/",
"Homepage": "https://github.com/oemof/tespy",
"Issue Tracker": "https://github.com/oemof/tespy/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "97a20ac69f7dadfd18cbd631db36ad8abd673105265685788906760b1f3a3008",
"md5": "7673db8992868fcbd1972cf4b34b92c6",
"sha256": "bd74ed9c2b1cc36b9a04c8202aec037d093a59bf7a8a20f1a072134ee222dea2"
},
"downloads": -1,
"filename": "TESPy-0.6.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "7673db8992868fcbd1972cf4b34b92c6",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 235535,
"upload_time": "2023-07-30T16:36:49",
"upload_time_iso_8601": "2023-07-30T16:36:49.955371Z",
"url": "https://files.pythonhosted.org/packages/97/a2/0ac69f7dadfd18cbd631db36ad8abd673105265685788906760b1f3a3008/TESPy-0.6.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9fc3f3f189e7e24b0f3c2deeaf57c87ac07e1adb759b70c210f01a99170aaeb3",
"md5": "861433826b63adab0b192799a95500f2",
"sha256": "fef40bc9844cde82d3e4e9e326469012ac95cd54f03f506a8bbdb38e486b5eb4"
},
"downloads": -1,
"filename": "TESPy-0.6.3.tar.gz",
"has_sig": false,
"md5_digest": "861433826b63adab0b192799a95500f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 1401527,
"upload_time": "2023-07-30T16:36:57",
"upload_time_iso_8601": "2023-07-30T16:36:57.550607Z",
"url": "https://files.pythonhosted.org/packages/9f/c3/f3f189e7e24b0f3c2deeaf57c87ac07e1adb759b70c210f01a99170aaeb3/TESPy-0.6.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-30 16:36:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "oemof",
"github_project": "tespy",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "tespy"
}
JSON
