dragonfly.extensionutil module¶
A series of utility functions that are useful across several dragonfly extensions.
- dragonfly.extensionutil.building_extension_dicts(building_list, extension_key, building_ext_dicts, story_ext_dicts, room2d_ext_dicts)[source]¶
Get all Building property dictionaries of an extension organized by geometry type.
- Parameters:
building_list – A list of Building dictionaries.
extension_key – Text for the key of the extension (eg. “energy”, “radiance”).
- Returns:
A tuple with three elements
building_ext_dicts: A list with the Building extension property dictionaries.
story_ext_dicts: A list with Story extension property dictionaries.
room2d_ext_dicts: A list with Room2D extension property dictionaries.
- dragonfly.extensionutil.context_shade_extension_dicts(context_shade_list, extension_key, context_shade_ext_dicts)[source]¶
Get all ContextShade property dictionaries of an extension.
- Parameters:
context_shade_list – A list of ContextShade dictionaries.
extension_key – Text for the key of the extension (eg. “energy”, “radiance”).
- Returns:
context_shade_ext_dicts – A list with ContextShade extension property dictionaries.
- dragonfly.extensionutil.model_extension_dicts(data, extension_key, building_ext_dicts, story_ext_dicts, room2d_ext_dicts, context_shade_ext_dicts)[source]¶
Get all Model property dictionaries of an extension organized by geometry type.
Note that the order in which dictionaries appear in the output lists is the same order as the geometry objects appear when requested from the model. For example, the shade_ext_dicts align with the model.shades.
- Parameters:
data – A dictionary representation of an entire honeybee-core Model.
extension_key – Text for the key of the extension (eg. “energy”, “radiance”).
- Returns:
A tuple with four elements
building_ext_dicts: A list of Building extension property dictionaries that align with the serialized model.buildings.
story_ext_dicts: A list of Story extension property dictionaries that align with the serialized model.stories.
room2d_ext_dicts: A list of Room2D extension property dictionaries that align with the serialized model.rooms.
context_shade_ext_dicts: A list of ContextShade extension property dictionaries that align with the serialized model.context_shades.
- dragonfly.extensionutil.room2d_extension_dicts(room2d_list, extension_key, room2d_ext_dicts)[source]¶
Get all Room2D property dictionaries of an extension.
- Parameters:
room2d_list – A list of Room2D dictionaries.
extension_key – Text for the key of the extension (eg. “energy”, “radiance”).
- Returns:
room2d_ext_dict – A list with Room2D extension property dictionaries.
- dragonfly.extensionutil.story_extension_dicts(story_list, extension_key, story_ext_dicts, room2d_ext_dicts)[source]¶
Get all Building property dictionaries of an extension organized by geometry type.
- Parameters:
building_list – A list of Building dictionaries.
extension_key – Text for the key of the extension (eg. “energy”, “radiance”).
- Returns:
A tuple with two elements
story_ext_dicts: A list with Story extension property dictionaries.
room2d_ext_dicts: A list with Room2D extension property dictionaries.