Skip to main content

A library to calculate human thermal comfort indexes

Project description

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

  • earthkit-meteo > 0.0.1 - for solar zenith angle calculation

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.

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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

thermofeel-2.1.0.tar.gz (22.4 kB view details)

Uploaded Source

Built Distribution

thermofeel-2.1.0-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file thermofeel-2.1.0.tar.gz.

File metadata

  • Download URL: thermofeel-2.1.0.tar.gz
  • Upload date:
  • Size: 22.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for thermofeel-2.1.0.tar.gz
Algorithm Hash digest
SHA256 0a209ae0bd0a32abb907a724742dd6f86864dffea888480d9e0e775410fe8f55
MD5 daab04c2cdb661c5a5f8e87150569d9c
BLAKE2b-256 df84cd307482dfe72efb0a1e9abe2b06f7c6246abfd1c7ef2f9e4eb5917d0f20

See more details on using hashes here.

File details

Details for the file thermofeel-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: thermofeel-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 19.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for thermofeel-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 86c76636955bd2492ecc75a3a4ba4e2e4e4685f9fed6468bedca8969f7101f48
MD5 d2a2b5b20ca96055ca9dcf048d981f40
BLAKE2b-256 e7903d3da694ab76a39a744b6aa528e869a8a6fcc2d23efec2213394751421ed

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page