create

dragonfly create

Commands for creating Dragonfly models.

dragonfly create [OPTIONS] COMMAND [ARGS]...

from-geojson

Create a Dragonfly model from a geojson file with building footprints.

Args:
geojson: Full path to a geoJSON file with building footprints as Polygons
or MultiPolygons.
dragonfly create from-geojson [OPTIONS] GEOJSON

Options

-l, --location <location>

An optional latitude and longitude, formatted as two floats separated by a comma, (eg. “42.3601,-71.0589”), defining the origin of the geojson file. If nothing is passed, the origin is autocalculated as the bottom-left corner of the bounding box of all building footprints in the geojson file.

-p, --point <point>

An optional X and Y coordinate, formatted as two floats separated by a comma, (eg. “200,200”), defining the origin of the geojson file in the space of the dragonfly model. The coordinates of this point are expected to be in the expected units of this Model.

Default:

'0,0'

-wr, --window-ratio <window_ratio>

A number between 0 and 1 (but not equal to 1) for the ratio between aperture area and wall area to be applied to all walls of all buildings. If specified, this will override the window_ratio key in the geojson.

--buildings-only, -all, --all-to-buildings

Flag to indicate if all geometries in the geojson file should be considered buildings. If buildings-only, this method will only generate footprints from geometries that are defined as a “Building” in the type field of its corresponding properties.

Default:

True

--no-context, -c, --existing-to-context

Flag to indicate whether polygons possessing a building_status of “Existing” under their properties should be imported as ContextShade instead of Building objects.

Default:

True

--separate-top-bottom, -ns, --no-separation

Flag to indicate whether top/bottom stories of the buildings should not be separated in order to account for different boundary conditions of the roof and ground floor.

Default:

True

-u, --units <units>

Text for the units system in which the resulting model geometry should be. Must be (Meters, Millimeters, Feet, Inches, Centimeters).

Default:

'Meters'

-t, --tolerance <tolerance>

The maximum difference between x, y, and z values at which vertices are considered equivalent.

-f, --output-file <output_file>

Optional file to output the Model JSON string. By default it will be printed out to stdout

Arguments

GEOJSON

Required argument

from-honeybee

Create a Dragonfly Model from Honeybee Model(s).

Args:
base_model: Full path to a Honeybee Model JSON or Pkl file that serves
as the base for the resulting Dragonfly Model. This model
determines the units and tolerance of the output model.
dragonfly create from-honeybee [OPTIONS] BASE_MODEL

Options

-c, --conversion-method <conversion_method>

Text to indicate how the Honeybee Rooms should be converted to Dragonfly. Choose from: AllRoom2D, ExtrudedOnly, AllRoom3D. Note that the AllRoom2D option may result in some loss or simplification of the 3D Honeybee geometry but ensures that all of the Dragonfly features for editing the rooms can be used. The ExtrudedOnly method will convert only the 3D Rooms that would have no loss or simplification of geometry when converted to Room2D. AllRoom3D keeps all detailed 3D geometry on the Building.room_3ds property, enabling you to convert the 3D Rooms to Room2D using the Building.convert_room_3ds_to_2d() method as you see fit.

Default:

'ExtrudedOnly'

-m, --other-model <other_model>

Another Honeybee Model to be added as a separate Building in the resulting Dragonfly Model.

-f, --output-file <output_file>

Optional file to output the Model DFJSON string. By default it will be printed out to stdout

Arguments

BASE_MODEL

Required argument

merge-models

Create a Dragonfly Model by merging multiple models together.

Args:
base_model: Full path to a Dragonfly Model JSON or Pkl file that serves
as the base into which the other model(s) will be merged. This model
determines the units and tolerance of the output model.
dragonfly create merge-models [OPTIONS] BASE_MODEL

Options

-m, --other-model <other_model>

The other Model to be merged into the base model.

-f, --output-file <output_file>

Optional file to output the Model DFJSON string. By default it will be printed out to stdout

Arguments

BASE_MODEL

Required argument