Skip to content

2.3 Face Schema

Chris Mackey edited this page Jan 28, 2020 · 7 revisions

A Face represents a single planar wall, roof, or floor. Faces form the backbone of the geometry within Honeybee models by parenting Apertures, Doors and Shades while also defining the volume of Rooms.

Honeybee Face Schema

The "face_type" key must be one of the following:

  • Wall
  • Floor
  • RoofCeiling
  • AirWall

The "boundary_condition" can be any of the object described in the boundary conditions documentation.

Child Apertures can be found underneath the optional "apertures" key and child Doors can be found underneath the optional "doors" key. These Apertures and Doors are expected to be co-planar with their parent Face and the Face geometry should NOT have holes cut in it for these child objects. If there's a particular simulation engine that requires holes to be cut in the parent Face, this is done automatically upon export and so Aperture and Door holes should never be included in files conforming to the Honeybee schema.

The Face also possesses a key for "indoor_shades", which can represent objects like the interior half of light shelves, as well as an "outdoor_shades" key, which can be used to represent overhangs, balconies, etc.