{"id":13723628,"url":"https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort","last_synced_at":"2025-05-07T17:30:38.862Z","repository":{"id":39413480,"uuid":"239588350","full_name":"CenterForTheBuiltEnvironment/pythermalcomfort","owner":"CenterForTheBuiltEnvironment","description":"Package to calculate several thermal comfort indices (e.g. PMV, PPD, SET, adaptive) and convert physical variables.","archived":false,"fork":false,"pushed_at":"2025-04-28T02:43:45.000Z","size":6023,"stargazers_count":170,"open_issues_count":24,"forks_count":57,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-05-04T16:49:18.965Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://pythermalcomfort.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CenterForTheBuiltEnvironment.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.bib","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-02-10T18:55:51.000Z","updated_at":"2025-04-30T13:56:33.000Z","dependencies_parsed_at":"2023-09-21T19:56:41.631Z","dependency_job_id":"f8c7877e-1688-496b-919e-615f9ce2bde9","html_url":"https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort","commit_stats":{"total_commits":667,"total_committers":6,"mean_commits":"111.16666666666667","dds":"0.21589205397301348","last_synced_commit":"496f3799de287737f2ea53cc6a8c900052a29aaa"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CenterForTheBuiltEnvironment%2Fpythermalcomfort","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CenterForTheBuiltEnvironment%2Fpythermalcomfort/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CenterForTheBuiltEnvironment%2Fpythermalcomfort/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CenterForTheBuiltEnvironment%2Fpythermalcomfort/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CenterForTheBuiltEnvironment","download_url":"https://codeload.github.com/CenterForTheBuiltEnvironment/pythermalcomfort/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252542064,"owners_count":21764907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T01:01:43.586Z","updated_at":"2025-05-07T17:30:38.850Z","avatar_url":"https://github.com/CenterForTheBuiltEnvironment.png","language":"Python","funding_links":[],"categories":["Consumption"],"sub_categories":["Buildings and Heating"],"readme":".. image:: https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort/raw/development/docs/images/pythermalcomfort-3-short.png\n  :align: center\n  :alt: pythermalcomfort logo\n\n================\npythermalcomfort\n================\n\nThe ``pythermalcomfort`` Python package is a comprehensive toolkit for calculating **thermal comfort indices**, **heat/cold stress metrics**, and **thermophysiological responses** based on international standards and peer-reviewed research.\nDesigned for researchers, engineers, and building science professionals, it simplifies complex calculations while ensuring accuracy and compliance with industry standards.\n\nKey Features\n============\n\n- **Thermal Comfort Calculations**:\n  Supports multiple models, including **PMV**, **PPD**, **adaptive comfort**, and **SET**.\n- **Heat and Cold Stress Indices**:\n  Calculate **UTCI**, **Heat Index**, **Wind Chill Index**, and **Humidex** for assessing environmental stress.\n- **Thermophysiological Models**:\n  Includes the **two-node (Gagge)** and **multinode (JOS-3)** models to estimate physiological responses like **core temperature**, **skin temperature**, and **skin wettedness**.\n- **Standards Compliance**:\n  Implements calculations based on **ASHRAE 55**, **ISO 7730**, **EN 16798**, and more.\n- **Ease of Use**:\n  Intuitive API for seamless integration into your projects.\n- **Extensive Documentation**:\n  Detailed guides, examples, and tutorials to help you get started quickly.\n- **Active Development**:\n  Regularly updated with new features, improvements, and bug fixes.\n- **Open Source**:\n  Licensed under the MIT License for maximum flexibility and transparency.\n\nWhy Use pythermalcomfort?\n=========================\n\n- **Accurate Assessments**:\n  Reliable thermal comfort and stress evaluations for diverse environments.\n- **Time-Saving**:\n  Automates complex calculations, saving you time and effort.\n- **Versatility**:\n  Ideal for researchers, engineers, and professionals in **building science**, **HVAC design**, **environmental design**, **thermal physiology**, **sport science**, and **biometeorology**.\n- **Enhanced Decision-Making**:\n  Empowers you to make data-driven decisions for **HVAC systems**, **building performance**, and **occupant comfort**.\n\nCite pythermalcomfort\n=====================\n\nIf you use ``pythermalcomfort`` in your research, please cite it as follows:\n\n.. code-block:: text\n\n   Tartarini, F., Schiavon, S., 2020.\n   pythermalcomfort: A Python package for thermal comfort research.\n   SoftwareX 12, 100578.\n   https://doi.org/10.1016/j.softx.2020.100578\n\nInstallation\n============\n\nInstall ``pythermalcomfort`` via pip:\n\n.. code-block:: bash\n\n   pip install pythermalcomfort\n\nFor advanced installation options, refer to the `Installation Instructions \u003chttps://pythermalcomfort.readthedocs.io/en/latest/installation.html\u003e`_.\n\nQuick Start\n===========\n\nGet started with ``pythermalcomfort`` in just a few lines of code:\n\n.. code-block:: python\n\n   from pythermalcomfort.models import pmv_ppd_iso, utci\n\n   # Calculate PMV and PPD using ISO 7730 standard\n   result = pmv_ppd_iso(\n       tdb=25,  # Dry Bulb Temperature in °C\n       tr=25,  # Mean Radiant Temperature in °C\n       vr=0.1,  # Relative air speed in m/s\n       rh=50,  # Relative Humidity in %\n       met=1.4,  # Metabolic rate in met\n       clo=0.5,  # Clothing insulation in clo\n       model=\"7730-2005\"  # Year of the ISO standard\n   )\n   print(f\"PMV: {result.pmv}, PPD: {result.ppd}\")\n\n   # Calculate UTCI for heat stress assessment\n   utci_value = utci(tdb=30, tr=30, v=0.5, rh=50)\n   print(f\"UTCI: {utci_value} °C\")\n\nFor more examples and detailed usage, check out models and indices in the models section of the documentation.\n\nContribute\n==========\n\nWe welcome contributions!\nWhether you’re reporting a bug, suggesting a feature, or submitting a pull request, your input helps make ``pythermalcomfort`` better for everyone.\nCheck out our contribution page in the documentation to get started.\n\nDocumentation\n=============\n\nFor detailed documentation, tutorials, and examples, visit our `Documentation \u003chttps://pythermalcomfort.readthedocs.io/en/latest/documentation/index.html\u003e`_.\n\nLicense\n=======\n\n``pythermalcomfort`` is released under the MIT License.\n\n\n=====\nStats\n=====\n\n.. start-badges\n\n.. list-table::\n    :stub-columns: 1\n\n    * - Documentation\n      - |docs|\n    * - License\n      - |license|\n    * - Downloads\n      - |downloads|\n    * - Tests\n      - | |appveyor|\n        | |codecov|\n        | |tests|\n    * - Package\n      - | |version| |wheel|\n        | |supported-ver|\n        | |package-health|\n\n.. |tests| image:: https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort/actions/workflows/build-test-publish.yml/badge.svg\n    :target: https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort/actions/workflows/build-test-publish.yml\n    :alt: Tests to ensure pythermalcomfort works on different Python versions and OS\n\n.. |package-health| image:: https://snyk.io/advisor/python/pythermalcomfort/badge.svg\n    :target: https://snyk.io/advisor/python/pythermalcomfort\n    :alt: pythermalcomfort\n\n.. |license| image:: https://img.shields.io/pypi/l/pythermalcomfort?color=brightgreen\n    :target: https://github.com/CenterForTheBuiltEnvironment/pythermalcomfort/blob/master/LICENSE\n    :alt: pythermalcomfort license\n\n.. |docs| image:: https://readthedocs.org/projects/pythermalcomfort/badge/?style=flat\n    :target: https://readthedocs.org/projects/pythermalcomfort\n    :alt: Documentation Status\n\n.. |downloads| image:: https://img.shields.io/pypi/dm/pythermalcomfort?color=brightgreen\n    :alt: PyPI - Downloads\n\n.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/CenterForTheBuiltEnvironment/pythermalcomfort?branch=master\u0026svg=true\n    :alt: AppVeyor Build Status\n    :target: https://ci.appveyor.com/project/CenterForTheBuiltEnvironment/pythermalcomfort\n\n.. |codecov| image:: https://codecov.io/github/CenterForTheBuiltEnvironment/pythermalcomfort/coverage.svg?branch=master\n    :alt: Coverage Status\n    :target: https://codecov.io/github/CenterForTheBuiltEnvironment/pythermalcomfort\n\n.. |version| image:: https://img.shields.io/pypi/v/pythermalcomfort.svg\n    :alt: PyPI Package latest release\n    :target: https://pypi.org/project/pythermalcomfort\n\n.. |wheel| image:: https://img.shields.io/pypi/wheel/pythermalcomfort.svg\n    :alt: PyPI Wheel\n    :target: https://pypi.org/project/pythermalcomfort\n\n.. |supported-ver| image:: https://img.shields.io/pypi/pyversions/pythermalcomfort.svg\n    :alt: Supported versions\n    :target: https://pypi.org/project/pythermalcomfort\n\n.. |supported-implementations| image:: https://img.shields.io/pypi/implementation/pythermalcomfort.svg\n    :alt: Supported implementations\n    :target: https://pypi.org/project/pythermalcomfort\n\n.. end-badges\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCenterForTheBuiltEnvironment%2Fpythermalcomfort","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCenterForTheBuiltEnvironment%2Fpythermalcomfort","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCenterForTheBuiltEnvironment%2Fpythermalcomfort/lists"}