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, AperturesandDoors` within a single object that can be applied broadly across the Model.

ConstructionSet Schema

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, 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 object for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face. interior_construction: A WindowConstruction object for all apertures with a Surface boundary condition. skylight_construction: : A WindowConstruction object 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 object for all apertures with an Outdoors boundary condition and True is_operable property.