Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

Dragonfly

ADDON. Version 1.0.0. Released on 2020. Provides 53 components. Created by Antonello Di Nunzio & Chris Mackey. Features 0 video tutorials.
Dragonfly allows users to model large-scale climate phenomena such as urban heat island. Dragonfly intends to make many large-scale climate variables accessible to CAD interfaces and the other insects of Ladybug Tools.
0 | Dragonfly
1 | Urban Weather
2 | Alternative Climate Data
3 | Envimet
4 | Developers

3 | Envimet

Envimet Source (DFEnvimetSource)
Use this component to generate sources for "Dragonfly Envimet Spaces". E.g. a fountain to apply evaporation strategy.
Envimet Read Building Avg Results (DFReadBuildingAvgResults)
Use this component to read building results. (WIP)
Envimet Config (DFenvimetConfig)
This component writes simulation file (SIMX) of ENVI_MET.
Envimet Config MainSettings (DFenvimetConfigMainSettings)
This component contain main settings to generate simulation file (SIMX).
Connect the output DF Envimet Config.
Envimet 2d Plant (DFEnvimet2dPlant)
Use this component to generate plant2d for "Dragonfly Envimet Spaces". E.g. grass, simple tree of 10 meters and so on.
Envimet Information (DFEnvimetInformation)
News and Info from DF Envimet developer!
Use this component to see roadmap of Dragonfly Envimet or patches released by developer
Envimet Spaces (DFEnvimetSpaces)
Use this component to generate ENVI-Met v4
Envimet Receptor Folder (DFReceptorFolder)
Use this component to get all output folders of receptors.
Envimet 3d Plant (DFEnvimet3dPlant)
Use this component to generate 3d trees for "Dragonfly Envimet Spaces". ENVI_MET has a big library of 3d tree divided into Coniferous and Deciduous
Envimet Timesteps Settings (DFenvimetTimestepsSettings)
This component let you change the timestep of the sun. For more info see the official website of ENVI_MET.
Envimet Run Simulation (DFEnvimetRunSimulation)
Use this component to run directly simulation by Grasshopper.
Envimet Building Temp (DFenvimetBuildingTemp)
This component let you change the indoor temperature of the buildings.
Envimet Grid (DFEnvimetGrid)
Use this component to generate inputs for "Envimet Spaces". Each Point of grid represent a centroid of an envimet cube.
Envimet Receptor (DFEnvimetReceptor)
Use this component to generate inputs for "Dragonfly Envimet Spaces"
Envimet Output interval Settings (DFenvimetOutputintervalSettings)
This component let you change the timestep of the sun. For more info see the official website of ENVI_MET.
Envimet Soil (DFEnvimetSoil)
Use this component to generate inputs for "Dragonfly Envimet Spaces"
Visualize Buildings (DFvisualizeBuildings)
Use this component to see buildings centroids of ENVI_MET model file.
Envimet Installation Directory (DFEnvimetInstallationDirectory)
Use this component to set Installation Directory of Envimet on your machine. E.g. C:NVImet444
Envimet Simple Force by EPW
This component let you force climate condition of the simulation
Envimet Building Files (DFBuildingFiles)
Use this component to get avg output files of buildings.
Edit Building Materials (DFeditBuildingMaterials)
Use this component to edit building materials. You can use it to generate windows.
You need to use both Curve and Shapes inputs for windows. Check where the points are using"DFvisualizeBuildings"
Envimet Buildings (DFEnvimetBuildings)
Use this component to generate buildings for "Dragonfly Envimet Spaces"
Envimet Soil settings (DFenvimetSoilSettings)
EXPERT SETTINGS: This component let you change initial condition of the soil.
Envimet Config SimpleForcing (DFenvimetConfigSimpleForcing)
This component let you force climate condition of the simulation. You can connect lists of values or data which comes from EPW file.
Use outputs of DF Envimet Simple Force by EPW.
Envimet Nesting Grid (DFEnvimetNestingGrid)
Use this component to generate inputs for "df_envimet Spaces"
Envimet Read Receptor Results (DFReadReceptorResults)
Use this component to read receptor results. Right click on icon of component to set output type:
Atmosphere;
Soil;
Flux.
Horizontal Overhang (DFhorizontalOverhang)
Use this component to horizontal overangs "Dragonfly Envimet Spaces".
Envimet Read Library (DFReadLibrary)
Use this component to read the library of materials of ENVI_MET.
Use the "id" to change materials to enviment objects.
Use DF XML Reader to look at details of materials.
Envimet Terrain (DFenvimetTerrain)
Use this component to generate inputs for "Dragonfly Envimet Spaces"
Envimet Manage Workspace (DFEnvimetManageWorkspace)
Use this component to create a Workspace folder
Envimet Run INX (DFEnvimetRunINX)
Use this component to open your ENVI_MET model directly with GH.
XML Reader (DFXMLReader)
Use this component to see details about materials.
Connect "XML" output of "DF Library Reader" and keywords to extract details. E.g. "Density", "Description"...
Envimet Default Material (DFEnvimetDefaultMaterial)
Use this component to override common wall material, common roof material and common soil material inputs for "Dragonfly Envimet Spaces"
Envimet Location (DFEnvimetLocation)
Use this component to generate inputs for "df_envimet Spaces"

1 | Urban Weather

Dragonfly_Bldg Age (bldg_age)
Provides a list of available building programs from the template
Typology From Params
Use this component to generate a default building typology to be used with the "DF City" component
City
Use this component to generate a Dragonfly City object from Dragonfly Bldgg Typology objects
City From Parameters
Use this component to generate a Dragonfly City object from numerical parameters like building height and site coverage ratio
Typology from Footprints
Use this component to generate a building typology to be used with the "DF City" component from footprint geometry.
-
Provided by Dragonfly 0.0.03
Dragonfly_Bldg Program (bldg_program)
Provides a list of available building programs from the template
Boundary Layer Parameters
Use this component to generate boundary layer parameters that can be plugged into the "DF Run Urban Weather Generator" component
Vegetation Parameters
Use this component to generate vegetation parameters that can be plugged into the "DF uwg City" component.
-
Provided by Dragonfly 0.0.03
Building Typology
Use this component to generate a default building typology to be used with the "DF City" component
Pavement Parameters
Use this component to generate parameters that describe the pavement of the urban area, which can be plugged into the "DF uwg City" component.
-
Provided by Dragonfly 0.0.03
Reference EPW Parameters
Use this component to generate refernce EPW site parameters that can be plugged into the "DF Run Urban Weather Generator" component
Edit Typology Envelope
Use this component to generate a default building typology to be used with the "DF City" component
Traffic Parameters
Use this component to generate traffic parameters that can be plugged into the "DF uwg City" component.
-
Provided by Dragonfly 0.0.03
Run Urban Weather Generator
Use this component to morph a rural or airport EPW to reflect the conditions within an urban street canyon

4 | Developers

Export Dragonfly
Code Developers of Dragonfly can use this component to export Dragonfly user objects and source code that they create to the Github folder on their computer
Update
This component installs the uwg libraries to:
C:sersUSERNAME%ppDataoamingcNeelhinoceros

2 | Alternative Climate Data

Import LANDSAT Image
Use this component to import a LADNSAT image that has been downloaded from GloVis into Grassoppper
AMY from NCDC Data
Use this component to create an AMY weather file from a year of data downloaded from the National Climactic Data Center (NCDC) database and an existing TMY weather file for the location

0 | Dragonfly

Dragonfly
This component carries all of Dragonfly's main classes

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Dragonfly and associated data © 2020 Antonello Di Nunzio & Chris Mackey.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service