Skip to content

ladybug-tools/ladybug-comfort

Repository files navigation

Ladybug

Build Status Coverage Status

Python 3.10 Python 3.7 Python 2.7 IronPython

ladybug-comfort

Ladybug-comfort is a Python library that adds thermal comfort functionalities to ladybug-core.

Installation

pip install ladybug-comfort

If you want to also include the dependencies needed for thermal mapping use:

pip install -U honeybee-energy[mapping]

To check if the Ladybug-comfort command line interface is installed correctly, use ladybug-comfort --help.

Usage

"""Get the percentage of time outdoor conditions are comfortable with/without sun + wind"""
from ladybug.epw import EPW
from ladybug_comfort.collection.utci import UTCI

epw_file_path = './tests/epw/chicago.epw'
epw = EPW(epw_file_path)
utci_obj_exposed = UTCI.from_epw(epw, include_wind=True, include_sun=True)
utci_obj_protected = UTCI.from_epw(epw, include_wind=False, include_sun=False)

print(utci_obj_exposed.percent_neutral)  # comfortable percent of time with sun + wind
print(utci_obj_protected.percent_neutral)  # comfortable percent of time without sun + wind

derivative work

Ladybug-comfort is a derivative work of the following software projects:

Applicable copyright notices for these works can be found within the relevant .py files.