1.1 Model Schema
The Dragonfly Model schema is an abstracted means of describing building geometry, which is intended to make it easier to build models of large buildings all of the way up to the scale of urban districts. While Dragonfly models are fully translatable into 3D space, the Dragonfly schema is fundamentally a 2D representation of Building geometry, where all rooms are assumed to be extrusions of floor plates. Such 2D rooms (aka. Room2Ds) represent the finest level of detail supported by the Dragonfly schema and all objects smaller than individual rooms like windows and shades are represented through simple sets of instructions for generating such objects (aka. WindowParameters and ShadingParameters).
The Dragonfly Model schema is designed to be extensible such that properties for various simulation engines can be assigned to building geometry. Schemas have been developed to extend the core Dragonfly Model for EnergyPlus/OpenStudio as well as Radiance. This section will focus on only describing the core Model schema in the absence of any extensions.
What Dragonfly lacks in terms of fine geometric detail, it makes up for in objects that help organize and edit building-scale properties. Altogether, Dragonfly Models are composed of 4 geometry objects. In order of most coarse/abstract to most fine/detailed, these objects are
- Building
- Story
- Room2D
- ContextShade
The relationships of these objects are as follows:
The coarsest object in the Dragonfly Model schema is the Building, which represents a single self-contained building and typically maps to an entire model within energy simulation workflows. Buildings are composed of Stories that represent individual floors of the building. Stories are composed of Room2Ds, which map to individual zones in energy simulation workflows and map to the Rooms of the Honeybee schema. Story objects have multipliers, which can be used to represent cases where the same floor is repeated several times over the height of a Building. Lastly, ContextShades are the only objects within the Dragonfly schema to support a full 3D representation. Both Buildings and ContextShades can be assigned to Dragonfly Models with the Buildings representing the simulation geometry and ContextShade representing objects like trees, terrain, monuments and other objects that might shade the simulation geometry. Shades attached to the building geometry should typically be represented with ShadingParameter objects that can be assigned to the segments of Room2Ds.
The relationship between Dragonfly objects in 3D space can be imagines ad follows:
