ladybug_comfort.asv module

Utility functions for calculating Actual Sensation Vote (ASV)

ladybug_comfort.asv.actual_sensation_vote(ta, ws, rh, sr)[source]

Calculate Actual Sensation Vote (ASV) from air temperature, wind speed, relative humidity and solar radiation.

Actual Sensation Vote is an index which estimates human thermal sensation based on the empirical data gathered from field and human surveys, interviews and questionnaires. Actual Sensation Vote is derived from original work carried out by Givoni and Noguchi [1].

Note

[1] Zambrano, Letícia & Malafaia, Cristina & Bastos, Leopoldo. (2006). Thermal comfort evaluation in outdoor space of tropical humid climate.

Parameters:

  • ta – Air temperature [C]

  • ws – Wind speed [m/s]

  • rh – Relative humidity [%]

  • sr – Solar radiation [Wh/m2]

Returns:

asv – Actual sensation vote [unitless]

ladybug_comfort.asv.actual_sensation_vote_effect_category(asv)[source]

Get the category of effect associated with a given actual sensation vote (ASV).

Each number (from -2 to 2) represents a certain ASV thermal sensation category. With categories being the following:

  • -2 = Very cold

  • -1 = Cold

  • 0 = Comfort

  • 1 = Hot

  • 2 = Very Hot

Parameters:

[unitless] (asv -- Actual Sensation Vote)

Returns:

category – An integer indicating the level of effect associated with the thermal sensation. Values are one of the following:

  • -2 = Very cold

  • -1 = Cold

  • 0 = Comfort

  • 1 = Hot

  • 2 = Very Hot