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 7 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 (about 5 years ago)
Default Branch: main
Last Pushed: 2026-07-09T00:05:23.000Z (13 days ago)
Last Synced: 2026-07-11T21:03:38.854Z (11 days ago)
Language: Python
Homepage: https://thermofeel.readthedocs.io
Size: 17.2 MB
Stars: 95
Watchers: 17
Forks: 23
Open Issues: 1
Releases: 23
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.bib
- Agents: AGENTS.md

thermofeel

[!IMPORTANT]
This software is Graduated and subject to ECMWF's guidelines on Software Maturity.

thermofeel (pronounced thermo-feel)

A library to calculate human thermal comfort indices.

Currently calculates the thermal indices:

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
Wet Bulb Globe Temperature (Liljegren method)
Heat Force (KNMI 0–10 heat-stress scale)
Excess Heat Factor and Excess Cold Factor
Wind Chill

In support of the above indices, it also calculates:

Globe Temperature
Mean Radiant Temperature
Mean Radiant Temperature from Globe Temperature
Relative Humidity Percentage
Saturation vapour pressure
Wet Bulb Temperature

PyPI

Install with:

pip install thermofeel

System dependencies

thermofeel core functions depend on:

numpy

Optionally, thermofeel depends on:

pytest — for unit testing

Release notes

Version 2.2 adds the physically based Liljegren Wet Bulb Globe Temperature and
the KNMI 0–10 Heat Force scale, the Excess Heat / Excess Cold Factors, inline
type hints with a py.typed marker, and raises the minimum Python to 3.10. See
the ChangeLog for
the full list.

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 the ChangeLog
for more details.

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.

Current developers:

Claudia Di Napoli — ECMWF
Tiago Quintino — ECMWF

See also the
contributors for a more
complete list.

License

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
adjoining
Acknowledgements.

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: 6
Commit comment event: 1
Release event: 2
Delete event: 3
Pull request event: 7
Fork event: 1
Watch event: 16
Issue comment event: 2
Push event: 33
Pull request review comment event: 1
Pull request review event: 1

Last Year

Delete event: 3
Pull request event: 3
Fork event: 1
Watch event: 4
Push event: 23
Pull request review comment event: 1
Pull request review event: 1
Create event: 2
Commit comment event: 1

Committers metadata

Last synced: 4 days ago

Total Commits: 532
Total Committers: 12
Avg Commits per committer: 44.333
Development Distribution Score (DDS): 0.329

Commits in past year: 93
Committers in past year: 4
Avg Commits per committer in past year: 23.25
Development Distribution Score (DDS) in past year: 0.226

Name	Email	Commits
Tiago Quintino	t**o@e**t	357
chlobrim	8****m	130
Claudia Di Napoli	c**i@e**t	21
Dusan Vuckovic	d**c@e**t	8
Christopher Polster	c**r@e**t	6
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:

Issue and Pull Request metadata

Last synced: 6 days ago

Total issues: 5
Total pull requests: 20
Average time to close issues: about 1 year
Average time to close pull requests: 2 months
Total issue authors: 5
Total pull request authors: 7
Average comments per issue: 1.2
Average comments per pull request: 0.75
Merged pull request: 12
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 8
Past year average time to close issues: N/A
Past year average time to close pull requests: 24 days
Past year issue authors: 2
Past year pull request authors: 5
Past year average comments per issue: 0.0
Past year average comments per pull request: 0.63
Past year merged pull request: 5
Past year bot issues: 0
Past year bot pull requests: 0

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

Top Issue Authors

tlmquintino (1)
oskrynyk (1)
bweeding (1)
jarataraj (1)
alb7 (1)

Top Pull Request Authors

tlmquintino (13)
34j (2)
cladinapoli (1)
iainrussell (1)
chpolste (1)
C-H-Simpson (1)
recmanj (1)

Top Issue Labels

Top Pull Request Labels

Package metadata

Total packages: 1
Total downloads:
- pypi: 8,017 last-month
Total dependent packages: 0
Total dependent repositories: 1
Total versions: 20
Total maintainers: 2

pypi.org: thermofeel

A library to calculate human thermal comfort indexes

Homepage:
Documentation: https://thermofeel.readthedocs.io/
Licenses: Apache Software License
Latest release: 2.2.0 (published about 1 month ago)
Last Synced: 2026-07-15T23:02:31.863Z (6 days ago)
Versions: 20
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 8,017 Last month
Rankings:
- Dependent packages count: 7.31%
- Stargazers count: 9.155%
- Forks count: 9.37%
- Downloads: 11.375%
- Average: 11.86%
- Dependent repos count: 22.088%
Maintainers (2)
- braoult
- ecmwf

Dependencies

docs/requirements.txt pypi

ipykernel *
nbsphinx *
sphinx *
sphinx_rtd_theme *

requirements.txt pypi

numba *
numpy *
pytest *

setup.py pypi

numpy *

.github/workflows/ci.yml actions

.github/workflows/cd.yml actions

Score: 16.038948542116398

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology