Skip to content

3.1 ConstructionSet Schema

Chris Mackey edited this page Jan 21, 2020 · 10 revisions

While assigning energy constructions to individual Faces, Apertures, Doors, and Shades is a valid way to set set up a Honeybee Model for energy simulation, it can quickly become tedious for large models. It also limits the edit-ability of Models if, for example, you want to swap out the construction used for all skylights in the model.

To address this, ConstructionSets allow you to specify default constructions for different types of Faces, Apertures and Doors within a single object that can be applied broadly across the Model.

ConstructionSet Schema

ConstructionSet logic

ConstructionSets can be assigned to individual Honeybee Rooms or can be assigned to a Model as a "global_construction_set'. In order to determine the construction of a given Face, Aperture, Door or Shade, the following logic is applied:

  1. Is there a construction assigned specifically to the Face? If so, use that.
  2. Is there a construction for this type of Face assigned to the parent Room's ConstructionSet? If so, use that.
  3. Is there a construction for this type of Face assigned to the Model's "global_construction_set'? If so, use that.

Note that filling all of the slots of a ConstructionSet and assigning it as the Model's "global_construction_set' will ensure that all objects lacking a construction will get a default assigned to them.

In addition to making Model constructions more easily editable, ConstructionSets can be used to create groups of constructions that comply with particular building codes, energy standards, or a basis of design used within a given office.

Definitions of object types

While the slots underneath WallSet, FloorSet and RoofCeilingSet are pretty clearly set by "face_type' and '"boundary_condition"of aFace, the properties that define the different types of Apertures, Doors, and Shades` are less obvious. For this reason, they are defined below:

ApertureSet

  • window_construction: A WindowConstruction for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face.
  • interior_construction: A WindowConstruction for all apertures with a Surface boundary condition.
  • skylight_construction: : A WindowConstruction for apertures with a Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.
  • operable_construction: A WindowConstruction for all apertures with an Outdoors boundary condition and True is_operable property.

DoorSet

  • exterior_construction: An OpaqueConstruction for opaque doors with an Outdoors boundary condition and a Wall face type for their parent face.
  • interior_construction: An OpaqueConstruction for all opaque doors with a Surface boundary condition.
  • exterior_glass_construction: A WindowConstruction for all glass doors with an Outdoors boundary condition.
  • interior_glass_construction: A WindowConstruction for all glass doors with a Surface boundary condition.
  • overhead_construction: An OpaqueConstruction for opaque doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.

Shade

Note that the "shade" construction within a ConstructionSet is only applied to Shades that have a parent. If the parent is an Aperture or Face, the ConstructionSet of the parent Room of these objects will assign the Shade or the Model "global_construction_set' will assign it. However, orphaned Shades are unaffected by ConstructionSets and, if they don't have a ShadeConstruction assigned specifically to them, they will use the EnergyPlus default of a 0.2 diffusely reflective context.