Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

0 | Dragonfly
1 | Urban Weather
2 | Alternative Climate Data
3 | Envimet
4 | Developers

Use this component to generate a Dragonfly City object from Dragonfly Bldgg Typology objects. These building typologies can generated with the "DF Building Typology" component.
_
The ouput of this component can be plugged into the 'Dragonfly_Run Urban Weather Generator' component to morph a rural/airport weather file to reflect the urban climate.
-
Provided by Dragonfly 0.0.03

Inputs

NameIDDescriptionType
typologies_typologiesOne or more building typologies from the "DF Building Typology" component.Goo
terrain_terrainA brep or list of breps that represent the the terrian beneath the urban area, including all pavement, grass areas, and the region beneath the buildings. Note that this brep should just reflect the surface of the terrain and should not be a closed solid. The outer limits of this surface will be used to determine the density of the urban area so including surface area that extends well beyond the buildings will cause the simulation to inacurately model the density.Goo
treestrees_Either a list of horizontal surfaces that represent the tree canopies of the urban area or a number between 0 and 1 that represents that fraction of tree coverage over the entire urban area (including those over both roofs and pavement). If breps are input, they will be projected to the ground plane to compute the area of tree coverage as seen from above. Thus, simpler tree geometry like boxes that represent the tree canopies are preferred. If nothing is input here, it will be assumed that there are no trees in the urban area.Goo
grassgrass_Either a list of surfaces that represent the grassy surfaces of the urban area or a number between 0 and 1 that represents that fraction of grass coverage over the entire urban area (including both green roofs and ground vegetation). If surfaces are input here, they should be coplanar with the terrainBrep. If nothing is input here, it will be assumed that there is no grass in the urban area.Goo
--------------------------------...Goo
climate_zone_climate_zoneA text string representing the ASHRAE climate zone. (eg. 5A). This is used to set default constructions for the buildings in the city.Goo
traffic_par_traffic_parTraffic parameters from the "DF Traffic Parameters" component. This input is required as anthropogenic heat from traffic can significantly affect urban climate and varies widely between commerical, residential, and industrial districts.Goo
vegetation_parvegetation_par_An optional set of vegetation parameters from the "DF Vegetation Parameters" component. If no vegetation parameters are input here, the Dragonfly will use a vegetation albedo of 0.25, tree latent fraction of 0.7, and grass latent fraction of 0.6. Furthermore, Dragonfly will attempt to determine the months in which vegetation is active by looking at the average monthly temperatures in the EPW file.Goo
pavement_parpavement_par_An optional set of pavement parameters from the "DF Pavement Parameters" component. If no paramters are plugged in here, it will be assumed that all pavement is asphalt.Goo
--------------------------------Script variable CityGoo
run_runSet to 'True' to run the component and generate the uwg city from the connected inputs.Goo

Outputs

NameIDDescriptionType
outread_me...String
----------------------...Goo
citycityA Drafongfly city objectthat can be plugged into the "DF Run Urban Weather Generator" component.Goo
----------------------Script variable PythonGoo
tree_projtree_projIf tree breps are connected, this is the tree geometry as projected into the world XY plane. This is used to determine the tree coverage.Goo
grass_projgrass_projIf grass breps are connected, this is the tree geometry as projected into the world XY plane. This is used to determine the grass coverage.Goo
terrain_projterrain_projThe terrian brep projected into the world XY plane. The area of this surface is used to determine all other geometric parameters.Goo

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