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.
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).
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.
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