pythermalcomfort

The 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. Designed for researchers, engineers, and building science professionals, it simplifies complex calculations while ensuring accuracy and compliance with industry standards.

Key Features

• Thermal Comfort Calculations: Supports multiple models, including PMV, PPD, adaptive comfort, and SET.
• Heat and Cold Stress Indices: Calculate UTCI, Heat Index, Wind Chill Index, and Humidex for assessing environmental stress.
• Thermophysiological Models: Includes the two-node (Gagge) and multinode (JOS-3) models to estimate physiological responses like core temperature, skin temperature, and skin wettedness.
• Standards Compliance: Implements calculations based on ASHRAE 55, ISO 7730, EN 16798, and more.
• Ease of Use: Intuitive API for seamless integration into your projects.
• Extensive Documentation: Detailed guides, examples, and tutorials to help you get started quickly.
• Active Development: Regularly updated with new features, improvements, and bug fixes.
• Open Source: Licensed under the MIT License for maximum flexibility and transparency.

Why Use pythermalcomfort?

• Accurate Assessments: Reliable thermal comfort and stress evaluations for diverse environments.
• Time-Saving: Automates complex calculations, saving you time and effort.
• Versatility: Ideal for researchers, engineers, and professionals in building science, HVAC design, environmental design, thermal physiology, sport science, and biometeorology.
• Enhanced Decision-Making: Empowers you to make data-driven decisions for HVAC systems, building performance, and occupant comfort.

Cite pythermalcomfort

If you use pythermalcomfort in your research, please cite it as follows:

Tartarini, F., Schiavon, S., 2020. pythermalcomfort: A Python package for thermal comfort research. SoftwareX 12, 100578. https://doi.org/10.1016/j.softx.2020.100578

Installation

Install pythermalcomfort via pip:

pip install pythermalcomfort

For advanced installation options, refer to the installation Section in the documentation.

Quick Start

Get started with pythermalcomfort in just a few lines of code:

from pythermalcomfort.models import pmv_ppd_iso, utci

# Calculate PMV and PPD using ISO 7730 standard
result = pmv_ppd_iso(tdb=25, tr=25, vr=0.1, rh=50, met=1.4, clo=0.5, model='7730-2005')
print(f"PMV: {result.pmv}, PPD: {result.ppd}")

# Calculate UTCI for heat stress assessment
utci_value = utci(tdb=30, tr=30, v=0.5, rh=50)
print(f"UTCI: {utci_value} °C")

For more examples and detailed usage, check out models and indices in the models section of the documentation.

Contribute

We welcome contributions! Whether you’re reporting a bug, suggesting a feature, or submitting a pull request, your input helps make pythermalcomfort better for everyone. Check out our contribution page in the documentation to get started.

Documentation

For detailed documentation, tutorials, and examples, visit our documentation.

License

pythermalcomfort is released under the MIT License.

Stats

Documentation
License
Downloads
Tests
Package