ladybug_comfort.ts module¶
Utility functions for calculating Thermal Sensation (TS).
- ladybug_comfort.ts.thermal_sensation(ta, ws, rh, sr, tground)[source]¶
Calculate Thermal Sensation (TS) from air temperature, wind speed, relative humidity, solar radiation and ground temperature.
Thermal Sensation is an index which predicts sensation of satisfaction/dissatisfaction under the prevailing outdoor climatic conditions. Thermal Sensation is derived from original work carried out by Givoni and Noguchi [1].
Note
[1] Givoni, Baruch & Noguchi, Mikiko & Saaroni, Hadas & Potchter, Oded & Yaakov, Yaron & Feller, Noa & Becker, Stefan. (2003). Outdoor comfort research issues. Energy and Buildings. 35. 77-86. 10.1016/S0378-7788(02)00082-8.
- Parameters
ta – Air temperature [C]
ws – Wind speed [m/s]
rh – Relative humidity [%]
sr – Solar radiation [Wh/m2]
tground – Ground temperature [C]
- Returns
ts – Thermal sensation [unitless]
- ladybug_comfort.ts.thermal_sensation_effect_category(ts)[source]¶
Get the category of effect associated with a given thermal sensation (TS).
Each number (from -3 to 3) represents a certain TS thermal sensation category. With categories being the following:
-3 = Very cold
-2 = Quite cold
-1 = Cold
0 = Comfort
1 = Hot
2 = Quite Hot
3 = Very hot
- Parameters
ts – Thermal Sensation [unitless]
- Returns
category – An integer indicating the level of effect associated with the thermal sensation. Values are one of the following:
-3 = Very cold
-2 = Quite cold
-1 = Cold
0 = Comfort
1 = Hot
2 = Quite Hot
3 = Very hot