-
Notifications
You must be signed in to change notification settings - Fork 9
3.1 ConstructionSet Schema
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.
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:
- Is there a construction assigned specifically to the
Face
? If so, use that. - Is there a construction for this type of
Face
assigned to the parent Room'sConstructionSet
? If so, use that. - 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.
While the slots underneath WallSet
, FloorSet
and RoofCeilingSet
are pretty clearly set by "face_type'
and '"boundary_condition"of a
Face, the properties that define the different types of
Apertures,
Doors, and
Shades` are less obvious. For this reason, they are defined below:
-
window_construction: A
WindowConstruction
for apertures with anOutdoors
boundary condition, Falseis_operable
property, and aWall
face type for their parent face. -
interior_construction: A
WindowConstruction
for all apertures with aSurface
boundary condition. -
skylight_construction: : A
WindowConstruction
for apertures with aOutdoors
boundary condition, Falseis_operable
property, and aRoofCeiling
orFloor
face type for their parent face. -
operable_construction: A
WindowConstruction
for all apertures with anOutdoors
boundary condition and Trueis_operable
property.
-
exterior_construction: An
OpaqueConstruction
for opaque doors with anOutdoors
boundary condition and aWall
face type for their parent face. -
interior_construction: An
OpaqueConstruction
for all opaque doors with aSurface
boundary condition. -
exterior_glass_construction: A
WindowConstruction
for all glass doors with anOutdoors
boundary condition. -
interior_glass_construction: A
WindowConstruction
for all glass doors with aSurface
boundary condition. -
overhead_construction: An
OpaqueConstruction
for opaque doors with anOutdoors
boundary condition and aRoofCeiling
orFloor
face type for their parent face.
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.