- [source code]

Preview any Dragonfly geometry object as floor plates within the Rhino scene, including all stories represented by multipliers

Inputs

• df_objs [Required]

A Dragonfly Model, Building, Story, Room2D, or ContextShade to be previewed as a list of floor plates in the Rhino scene.

Outputs

• geo

The Rhino version of the Dragonfly geometry object, which will be visible in the Rhino scene.

• Visualize All

• Visualize Floors

• Visualize Quick

• Visualize Wireframe

• Geometry Properties

• Room2D Attributes

• Color Room2D Attributes

• Room2Ds by Attribute

• Color Network Attributes

• Network Attributes

• Color Network Results

- [source code]

Quickly preview any Dragonfly geometry object within the Rhino scene.

Any stories represented by multipliers will not be included in the output, allowing for a faster preview of large lists of objects but without the ability to check the multipliers of objects.

Inputs

• df_objs [Required]

A Dragonfly Model, Building, Story, Room2D, or ContextShade to be previewed in the Rhino scene.

Outputs

• geo

The Rhino version of the Dragonfly geometry object, which will be visible in the Rhino scene.

- [source code]

Quickly preview any Dragonfly geometry object as a wire frame within the Rhino scene, including all stories represented by multipliers

Inputs

• df_objs [Required]

A Dragonfly Model, Building, Story, Room2D, or ContextShade to be previewed as a wire frame in the Rhino scene.

Outputs

• geo

The Rhino version of the Dragonfly geometry object, which will be visible in the Rhino scene.

- [source code]

Color Dragonfly Room2Ds in the Rhino scene using their attributes.

This can be used as a means to check that correct properties are assigned to different Room2Ds.

Inputs

• df_obj [Required]

A Dragonfly Model, Building, Story or Room2D to be colored with their attributes in the Rhino scene.

• attribute [Required]

Text for the name of the Room2D attribute with which the Room2Ds should be colored. The "DF Room2D Attributes" component lists all of the attributes of the Room2D.

• legend_par

An optional LegendParameter object to change the display of the colored Room2Ds. (Default: None).

Outputs

• mesh

Meshes of the Room2D floors colored according to their attributes.

• legend

Geometry representing the legend for colored meshes.

• wire_frame

A list of lines representing the outlines of the rooms.

• values

A list of values that align with the input Room2Ds noting the attribute assigned to each Room2D.

• colors

A list of colors that align with the input Room2Ds, noting the color of each Room2D in the Rhino scene. This can be used in conjunction with the native Grasshopper "Custom Preview" component and other dragonfly visualization components (like "DF Visulaize All") to create custom visualizations in the Rhino scene.

- [source code]

Color a Dragonfly ElectricalNewtwork in the Rhino scene using its attributes.

This can be used as a means to check that correct properties are assigned to different Transformers and ElectricalConnectors.

Inputs

• network [Required]

A Dragonfly Electrical Newtork object to be colored with its attributes in the Rhino scene.

• attribute [Required]

Text for the name of the equipment attribute with which the Newtork should be colored. The "DF Network Attributes" component lists all of the attributes of the equipment of an ElectricalNetwork.

• legend_par

An optional LegendParameter object to change the display of the colored output. (Default: None).

Outputs

• vis_geo

Meshes and line segments colored according to their attributes.

• legend

Geometry representing the legend for colored objects.

• values

A list of values that align with the input substation, transformers and electrical connectors. These note the attribute assigned to each object.

• colors

A list of colors that align with the input substation, transformers and electrical connectors. These note the color of each object in the Rhino scene.

- [source code]

Get properties of any Dragonfly geometry object.

Inputs

• df_objs [Required]

  A Dragonfly Model, Building, Story or Room2D for which properties will be output.

Outputs

• height

  For a Model or a Building, this will be the average height of the object above the ground. For a Story, this will be the floor-to-floor height and, for a Room2D, this will be the floor-to-ceiling height.

• floor_area

  A number for the floor area of all Rooms in the dragonfly object.

• ext_wall_area

  A number for the total area of walls in the dragonfly object with an Outdoors boundary condition.

• ext_win_area

  A number for the total area of windows in the dragonfly object with an Outdoors boundary condition.

• volume

  A number for the volume of all Rooms in the dragonfly object.

- [source code]

Separate and group dragonfly Room2Ds by any attribute that the room possesses.

This can be used to group Room2Ds by program, whether rooms are conditioned, etc.

Inputs

• df_obj [Required]

  A Dragonfly Model, Building, Story or Room2D to be separated and grouped based on room attributes.

• attribute [Required]

  Text for the name of the Room2D attribute by which the Room2Ds should be separated. The "DF Room2D Attributes" component lists all of the attributes of the Room2D.

Outputs

• values

  A list of values with one attribute value for each branch of the output rooms.

• room2ds

  A data tree of honeybee rooms with each branch of the tree representing a different attribute value.

- [source code]

Provides a list of dragonfly electrical network properties.

- [source code]

Preview any Dragonfly geometry object within the Rhino scene, including all stories represented by multipliers

Inputs

• df_objs [Required]

A Dragonfly Model, Building, Story, Room2D, or ContextShade to be previewed in the Rhino scene.

Outputs

• geo

The Rhino version of the Dragonfly geometry object, which will be visible in the Rhino scene.

- [source code]

Provides a list of dragonfly Room2D properties.

- [source code]

Color a Dragonfly ElectricalNewtwork in the Rhino scene with OpenDSS simulation results.

Inputs

• data [Required]

A list of data collections of the same data type, which will be used to color the network with simulation results. These should come from the "DF Read OpenDSS Result" component.

• network [Required]

A Dragonfly Electrical Newtork object to be colored with results in the Rhino scene.

• sim_step

An optional integer (greater than or equal to 0) to select a specific step of the data collections for which result values will be generated. If None, the geometry will be colored with the maximum of resutls in the _data, essentially describing the peak condition. (Default: None).

• period

A Ladybug analysis period to be applied to all of the input _data.

• legend_par

An optional LegendParameter object to change the display of the colored output. (Default: None).

Outputs

• vis_geo

Meshes and line segments colored according to the results.

• legend

Geometry representing the legend for colored objects.

• title

A text object for the global title.

• values

A list of values that align with the input substation, transformers and electrical connectors. These note the value assigned to each object.

• colors

A list of colors that align with the input substation, transformers and electrical connectors. These note the color of each object in the Rhino scene.