honeybee_radiance.lightsource.sky.strutil module¶

Utilities to convert sky strings to Python objects.

honeybee_radiance.lightsource.sky.strutil.string_to_sky(sky_string, raise_exception=True)[source]¶

Get a Python object of any sky from a string representation.

Parameters:

sky_string – A text string representing a CIE, ClimateBased, or CertainIrradiance sky. This can be a minimal representation of the sky (eg. “cie -alt 71.6 -az 185.2 -type 0”). Or it can be a detailed specification of time and location (eg. “cie 21 Jun 12:00 -lat 41.78 -lon -87.75 -type 0”).
raise_exception – Boolean to note whether an exception should be raised if the object is not identified as a sky. Default: True.

Returns:

A Python object derived from the input sky_string.