Thermofeel

A library to calculate human thermal comfort indexes.
https://github.com/ecmwf/thermofeel

Category: Consumption
Sub Category: Buildings and Heating

Keywords from Contributors

weather-forecasting cold heat thermal-confort grib bufr meteorology wmo earth-science odb

Last synced: about 21 hours ago
JSON representation

Repository metadata

thermofeel is a library to calculate human thermal comfort indexes

• Host: GitHub
• URL: https://github.com/ecmwf/thermofeel
• Owner: ecmwf
• License: apache-2.0
• Created: 2021-06-17T15:52:26.000Z (over 4 years ago)
• Default Branch: develop
• Last Pushed: 2025-12-05T11:40:22.000Z (19 days ago)
• Last Synced: 2025-12-12T13:38:51.376Z (12 days ago)
• Language: Python
• Homepage: https://thermofeel.readthedocs.io
• Size: 14.8 MB
• Stars: 85
• Watchers: 18
• Forks: 19
• Open Issues: 0
• Releases: 20
• Metadata Files:
  • Readme: README.rst
  • Changelog: ChangeLog.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Citation: CITATION.bib

README.rst

          .. image:: https://raw.githubusercontent.com/ecmwf/thermofeel/master/thermofeel.png
  :width: 600
  :alt: thermofeel logo

|license| |tag_release| |docs| |ci|

**thermofeel** (pronounced *thermo-feel*)

A library to calculate human thermal comfort indexes.

Currently calculates the thermal indexes:
  * Universal Thermal Climate Index
  * Apparent Temperature
  * Heat Index Adjusted
  * Heat Index Simplified
  * Humidex
  * Normal Effective Temperature
  * Wet Bulb Globe Temperature
  * Wet Bulb Globe Temperature Simple
  * Wind Chill

In support of the above indexes, it also calculates:
  * Globe Temperature
  * Mean Radiant Temperature
  * Mean Radiant Temperature from Globe Temperature
  * Relative Humidity Percentage
  * Saturation vapour pressure
  * Wet Bulb Temperature

PyPi
====

|pypi_status|  |pypi_release| |pypi_downloads| |code_size|

Install with::

    $ pip install thermofeel

System dependencies
===================

thermofeel core functions depend on:
 * numpy

Optionally, thermofeel depends on:
 * pytest - for unit testing


Release notes
=============

Thermofeel 2.0 brings a number of changes to the underlying code but most importantly to the API.

Consequently, downstream packages using thermofeel 1.* will require code changes to migrate to version 2.0 and beyond.

The main changes are:
 * standardisation of input and output variables
 * standardisation of variable names
 * removal of dependency on numba for code acceleration
 * removal of solar zenith angle calculation (now provided by earthkit-meteo)
 * several bug fixes and improvements

Please consult ChangeLog_ for more details.

.. _ChangeLog: https://github.com/ecmwf/thermofeel/blob/master/ChangeLog.rst


Contributing
============

The main repository is hosted on `GitHub `_. Testing, bug reports and contributions are highly welcomed and appreciated.

Please see the Contributing_ document for the best way to help.

.. _Contributing: https://github.com/ecmwf/thermofeel/blob/master/CONTRIBUTING.rst

Current developers:

- Claudia Di Napoli - `ECMWF `_
- Tiago Quintino - `ECMWF `_

See also the `contributors `_ for a more complete list.

License
=======

Copyright 2021 European Centre for Medium-Range Weather Forecasts (ECMWF)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation nor
does it submit to any jurisdiction.

Citing
======


In publications, please use our paper in SoftwareX as the main citation for **thermofeel**:

Brimicombe, C., Di Napoli, C., Quintino, T., Pappenberger, F., Cornforth, R., & Cloke, H. L. (2022). 
Thermofeel: A python thermal comfort indices library. SoftwareX, 18, 101005. 
https://doi.org/10.1016/j.softx.2022.101005


To cite **thermofeel** the code currently please use:

Brimicombe, C., Di Napoli, C., Quintino, T., Pappenberger, F., Cornforth, R., & Cloke, H. L. (2021).
*thermofeel: a python thermal comfort indices library* https://doi.org/10.21957/mp6v-fd16


Acknowledgements
================
Past and current funding and support for **thermofeel** is listed in the adjoning Acknowledgements_


.. _Acknowledgements: https://github.com/ecmwf/thermofeel/blob/master/ACKNOWLEDGEMENTS.rst


.. |last_commit| image:: https://img.shields.io/github/last-commit/ecmwf/thermofeel
    :target: https://github.com/ecmwf/thermofeel

.. |commits_since_release| image:: https://img.shields.io/github/commits-since/ecmwf/thermofeel/latest?sort=semver
    :target: https://github.com/ecmwf/thermofeel

.. |license| image:: https://img.shields.io/github/license/ecmwf/thermofeel
    :target: https://www.apache.org/licenses/LICENSE-2.0.html

.. |pypi_release| image:: https://img.shields.io/pypi/v/thermofeel?color=green
    :target: https://pypi.org/project/thermofeel

.. |pypi_status| image:: https://img.shields.io/pypi/status/thermofeel
    :target: https://pypi.org/project/thermofeel

.. |tag_release| image:: https://img.shields.io/github/v/release/ecmwf/thermofeel?sort=semver
    :target: https://github.com/ecmwf/thermofeel

.. |codecov| image:: https://codecov.io/gh/ecmwf/thermofeel/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/ecmwf/thermofeel

.. |ci| image:: https://img.shields.io/github/actions/workflow/status/ecmwf/thermofeel/ci.yml
  :target: https://github.com/ecmwf/thermofeel/actions

.. |pypi_downloads| image:: https://img.shields.io/pypi/dm/thermofeel
  :target: https://pypi.org/project/thermofeel

.. |code_size| image:: https://img.shields.io/github/languages/code-size/ecmwf/thermofeel?color=green
  :target: https://github.com/ecmwf/thermofeel
  
.. |docs| image:: https://readthedocs.org/projects/thermofeel/badge/?version=latest
  :target: https://thermofeel.readthedocs.io/en/latest/?badge=latest


        

Citation (CITATION.bib)

@article{brimicombe2022thermofeel,
  title={Thermofeel: A python thermal comfort indices library},
  author={Brimicombe, Chloe and Di Napoli, Claudia and Quintino, Tiago and Pappenberger, Florian and Cornforth, Rosalind and Cloke, Hannah L},
  journal={SoftwareX},
  volume={18},
  pages={101005},
  year={2022},
  publisher={Elsevier},
  url={https://doi.org/10.1016/j.softx.2022.101005},
  doi={10.1016/j.softx.2022.101005},
}

---

Owner metadata

• Name: European Centre for Medium-Range Weather Forecasts
• Login: ecmwf
• Email: Software.Support@ecmwf.int
• Kind: organization
• Description: Providing software to work with meteorological data and services
• Website: www.ecmwf.int
• Location: Shinfield Park, Reading, United Kingdom
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/6368067?v=4
• Repositories: 44
• Last ynced at: 2023-03-02T03:00:24.789Z
• Profile URL: https://github.com/ecmwf

---

GitHub Events

Total

• Create event: 4
• Commit comment event: 1
• Release event: 2
• Watch event: 13
• Issue comment event: 2
• Push event: 15
• Pull request review event: 1
• Pull request event: 6

Last Year

• Create event: 2
• Commit comment event: 1
• Release event: 1
• Watch event: 7
• Push event: 10
• Pull request review event: 1
• Pull request event: 3

---

Committers metadata

Last synced: 3 days ago

Name	Email	Commits
Tiago Quintino	t****o@e****t	290
chlobrim	8****m	130
Claudia Di Napoli	c****i@e****t	11
Dusan Vuckovic	d****c@e****t	8
Milana Vuckovic	m****c@e****t	2
Milan K	m****r@g****e	2
Iain Russell	4****l	2
Pedro Maciel	P****l@e****t	1
Claudio Iacopino	C****o@e****t	1
Christopher Barnard	C****d@e****t	1
Sateesh Masabathini	m****s@K****A	1

Committer domains:

• ecmwf.int: 7
• kw61242.kaust.edu.sa: 1
• gmx.de: 1

---

Issue and Pull Request metadata

Last synced: 15 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ecmwf/thermofeel

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 7,308 last-month
• Total dependent packages: 0
• Total dependent repositories: 1
• Total versions: 18
• Total maintainers: 2

---

Dependencies

Score: 15.737681871582003