ladybug_comfort.parameter.solarcal module¶
Parameters for specifying body characteristics for the SolarCal model.
- class ladybug_comfort.parameter.solarcal.SolarCalParameter(posture=None, sharp=None, body_azimuth=None, body_absorptivity=None, body_emissivity=None)[source]¶
Bases:
ComfortParameter
Parameters specifying body characteristics for the SolarCal model.
- Parameters
posture – A text string indicating the posture of the body. Letters must be lowercase. Choose from the following: “standing”, “seated”, “supine”. Default is “standing”.
sharp – A number between 0 and 180 representing the solar horizontal angle relative to front of person (SHARP). 0 signifies sun that is shining directly into the person’s face and 180 signifies sun that is shining at the person’s back. Default is 135, assuming that a person typically faces their side or back to the sun to avoid glare.
body_azimuth – A number (between 0 and 360) representing the direction that the human is facing in degrees (0=North, 90=East, 180=South, 270=West). If this number is greater than 360 or less than 0, it will be converted to the correct angle within this range. Default is None, which will assume that the sharp input dictates the degrees the human is facing from the sun.
body_absorptivity – A number between 0 and 1 representing the average shortwave absorptivity of the body (including clothing and skin color). Typical clothing values - white: 0.2, khaki: 0.57, black: 0.88 Typical skin values - white: 0.57, brown: 0.65, black: 0.84 Default is 0.7 for average (brown) skin and medium clothing.
body_emissivity – A number between 0 and 1 representing the average longwave emissivity of the body. Default is 0.95, which is almost always the case except in rare situations of wearing metallic clothing.
- Properties:
posture
sharp
body_azimuth
body_absorptivity
body_emissivity
- ToString()¶
Overwrite .NET ToString.
- duplicate()¶
Get a copy of this object.
- classmethod from_dict(data)[source]¶
Create a SolarCalParameter object from a dictionary.
- Parameters
data – A SolarCalParameter dictionary in following the format below.
{ 'type': 'SolarCalParameter', 'posture': 'standing', 'sharp': 90, 'body_azimuth': None, 'body_absorptivity': 0.65, 'body_emissivity': 0.9 }
- classmethod from_string(solarcal_parameter_string)[source]¶
Create an SolarCalParameter object from an SolarCalParameter string.
- POSTURES = ('standing', 'seated', 'supine')¶
- property body_absorptivity¶
Number representing the average shortwave absorptivity of the body.
Between 0 and 1. Includes clothing and skin color.
- property body_azimuth¶
Number representing the direction that the human is facing in degrees.
Between 0 and 360. 0=North, 90=East, 180=South, 270=West.
- property body_emissivity¶
Number representing the average longwave emissivity of the body.
Between 0 and 1. Typically 0.95.
- property comfort_model¶
Return the name of the comfort model to which the parameters belong.
- property posture¶
A text string indicating the posture of the body.
- property sharp¶
The solar horizontal angle relative to front of person (SHARP).
Between 0 and 180. 0 signifies sun that is shining directly into the person’s face and 180 signifies sun that is shining at the person’s back.