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