dragonfly_energy.properties.model module

Model Energy Properties.

class dragonfly_energy.properties.model.ModelEnergyProperties(host)[source]

Bases: object

Energy Properties for Dragonfly Model.

Parameters:

host – A dragonfly_core Model object that hosts these properties.

Properties:

  • host

  • materials

  • constructions

  • face_constructions

  • shade_constructions

  • construction_sets

  • global_construction_set

  • schedule_type_limits

  • schedules

  • construction_schedules

  • shade_schedules

  • program_type_schedules

  • hvac_schedules

  • misc_room_schedules

  • program_types

  • hvacs

  • shws

ToString()[source]
apply_properties_from_dict(data)[source]

Apply the energy properties of a dictionary to the host Model of this object.

Parameters:

data – A dictionary representation of an entire dragonfly-core Model. Note that this dictionary must have ModelEnergyProperties in order for this method to successfully apply the energy properties.

check_all(raise_exception=True)[source]

Check all of the aspects of the Model energy properties.

Parameters:

raise_exception – Boolean to note whether a ValueError should be raised if any errors are found. If False, this method will simply return a text string with all errors that were found.

Returns:

A text string with all errors that were found. This string will be empty of no errors were found.

check_duplicate_construction_set_identifiers(raise_exception=True, detailed=False)[source]

Check that there are no duplicate ConstructionSet identifiers in the model.

Parameters:

  • raise_exception – Boolean to note whether a ValueError should be raised if duplicate identifiers are found. (Default: True).

  • detailed – Boolean for whether the returned object is a detailed list of dicts with error info or a string with a message. (Default: False).

Returns:

A string with the message or a list with a dictionary if detailed is True.

check_duplicate_hvac_identifiers(raise_exception=True, detailed=False)[source]

Check that there are no duplicate HVAC identifiers in the model.

Parameters:

  • raise_exception – Boolean to note whether a ValueError should be raised if duplicate identifiers are found. (Default: True).

  • detailed – Boolean for whether the returned object is a detailed list of dicts with error info or a string with a message. (Default: False).

Returns:

A string with the message or a list with a dictionary if detailed is True.

check_duplicate_program_type_identifiers(raise_exception=True, detailed=False)[source]

Check that there are no duplicate ProgramType identifiers in the model.

Parameters:

  • raise_exception – Boolean to note whether a ValueError should be raised if duplicate identifiers are found. (Default: True).

  • detailed – Boolean for whether the returned object is a detailed list of dicts with error info or a string with a message. (Default: False).

Returns:

A string with the message or a list with a dictionary if detailed is True.

check_duplicate_shw_identifiers(raise_exception=True, detailed=False)[source]

Check that there are no duplicate SHW identifiers in the model.

Parameters:

  • raise_exception – Boolean to note whether a ValueError should be raised if duplicate identifiers are found. (Default: True).

  • detailed – Boolean for whether the returned object is a detailed list of dicts with error info or a string with a message. (Default: False).

Returns:

A string with the message or a list with a dictionary if detailed is True.

duplicate(new_host=None)[source]

Get a copy of this Model.

Parameters:

new_host – A new Model object that hosts these properties. If None, the properties will be duplicated with the same host.

to_dict()[source]

Return Model energy properties as a dictionary.

to_honeybee(new_host)[source]

Get a honeybee version of this object.

Parameters:

new_host – A honeybee-core Model object that will host these properties.

property construction_schedules

Get a list of all unique schedules assigned to constructions in the model.

This includes schedules on al AirBoundaryConstructions, WindowConstructionShade, and WindowConstructionDynamic.

property construction_sets

Get a list of all unique ConstructionSets in the Model.

Note that this includes ConstructionSets assigned to individual Stories, Room2Ds and 3D Honeybee Rooms in the Model’s Buildings.

property constructions

Get a list of all unique constructions in the model.

This includes materials across all Room2Ds, Stories, and Building ConstructionSets but it does NOT include the Honeybee generic default construction set.

property face_constructions

Get a list of all unique constructions assigned to Faces, Apertures and Doors.

These objects only exist under the Building.room_3ds property and in the Building’s ceiling_plenum_construction and floor_plenum_construction.

property global_construction_set

The global energy construction set.

This is what is used whenever there is no construction_set assigned to a Room2D, a parent Story, or a parent Building.

property host

Get the Model object hosting these properties.

property hvac_schedules

Get a list of all unique HVAC-assigned schedules in the model.

property hvacs

Get a list of all unique HVAC systems in the Model.

property materials

Get a list of all unique materials contained within the model.

This includes materials across all Room2Ds, Stories, and Building ConstructionSets but it does NOT include the Honeybee generic default construction set.

property misc_room_schedules

Get a list of all unique schedules assigned directly to Rooms in the model.

This includes schedules for process loads and window ventilation control that are assigned to Room2Ds. It also includes any schedules assigned directly to 3D Honeybee Rooms of the model (not through the room program).

Note that this does not include schedules from ProgramTypes assigned to the rooms. For this, use the program_type_schedules property.

property program_type_schedules

A list of all unique schedules assigned to ProgramTypes in the model.

property program_types

Get a list of all unique ProgramTypes in the Model.

This includes ProgramTypes assigned to both Room2Ds and 3D Honeybee Rooms.

property schedule_type_limits

Get a list of all unique schedule type limits contained within the model.

This includes schedules across all ContextShades and Room2Ds.

property schedules

Get a list of all unique schedules in the model.

This includes schedules across all ProgramTypes and ContextShades.

property shade_constructions

Get a list of all unique constructions assigned to ContextShades in the model.

This will also include any Shade objects assigned to the 3D Honeybee Rooms of any Model Buildings.

property shade_schedules

Get a list of all unique schedules assigned to ContextShades in the model.

property shws

Get a list of all unique Service Hot Water (SHW) systems in the Model.