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.

get_sharp(solar_azimuth)[source]
to_dict()[source]

SolarCalParameter dictionary representation.

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.