Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

0 | Gismo
1 | OpenStreetMap
2 | Terrain
3 | More

Use this component to perform the following terrain analysis types:
-
- Slope
- Grade
- Aspect
- Elevation
- Visibility
- Hillshade
- TRI (Terrain Ruggedness Index by Riley)
- TRI categories (Terrain Ruggedness Index categories by Riley)
- SRF (Surface Roughness Factor by Hobson)
- TPI (Topographic Position Index)
- Mean curvature
------
Component mainly based on:
"DEM Surface Tools for ArcGIS", Jenness Enterprises, 2013.
"How Hillshade works" article from Esri Developer Network
"How to calculate Topographic Ruggedness Index in ArcGIS Desktop" article from gis.stackexchange.com
"Terrain Roughness – 13 Ways" article from gis4geomorphology.com
TopoToolbox "roughness" function by Wolfgang Schwanghart
-
http://www.jennessent.com/downloads/DEM%20Surface%20Tools%20for%20ArcGIS_A4.pdf
http://edndoc.esri.com/arcobjects/9.2/net/shared/geoprocessing/spatial_analyst_tools/how_hillshade_works.htm
http://gis.stackexchange.com/a/6059/65002
http://gis4geomorphology.com/roughness-topographic-position
https://github.com/wschwanghart/topotoolbox/blob/master/@GRIDobj/roughness.m
-
Provided by Gismo 0.0.3

Inputs

NameIDDescriptionType
Analysis Type_analysisTypeChoose one of the terrain analysis types: 0 - Slope 1 - Grade 2 - Aspect 3 - Elevation 4 - Visibility 5 - Hillshade 6 - TRI (Terrain Ruggedness Index by Riley) 7 - TRI categories (Terrain Ruggedness Index categories by Riley) 8 - SRF (Surface Roughness Factor by Hobson) 9 - TPI (Topographic Position Index) 10 - Mean curvatureGoo
_______________Script variable TerrainGenerator2Goo
Terrain_terrainA terrain surface or polysurface. Add it by supplying the "terrain" output from the Ladybug "Terrain Generator" or Gismo "Terrain Generator" components. - It needs to be a surface. So set the: "type_" input of the Ladybug "Terrain Generator" component to "1" or "type_" input of the Gismo "Terrain Generator" component to "2" or "3"Goo
Origin_originAn origin (point on a "_terrain") of the upper "_terrain" input. Add it by suppling the "origin" output from the Ladybug "Terrain Generator" component. or Add it by supplying the "origin" output from the Gismo "Terrain Generator" component.Goo
Elevation_elevationElevation of the upper "_origin". Add it by supplying the "elevation" output from the Ladybug "Terrain Generator" component. or Add it by supplying the "elevation" output from the Gismo "Terrain Generator" component. - In Rhino document units.Goo
Contextcontext_These are obstacles surrounding your location: houses, buildings, trees etc. For example, you can use 3d buildings and 3d trees generated by Gismo's "OSM 3D" component. - This input can not be included in the final "analysedTerrain" geometry for the following indices: TRI, TRI categories, SRF, TPI (_analysisType = 6,7,8,9) The reason for this is because these indices exclusively calculate terrain features.Goo
Northnorth_Input a vector to be used as a true North direction, or a number between 0 and 360 that represents the clockwise degrees off from the Y-axis. - If not supplied, default North direction will be set to the Y-axis (0 degrees).Goo
Sun VectorsunVector_Illuminance source direction. This input is only used for _analysisType = 5 (Hillshade). - If not supplied, default sunVector of (0, 2.37126, -2.37126) will be used (an Y+ vector angled at 45 degrees downwards).Goo
Hypso StrengthhypsoStrength_Hypsometric strength - a factor which determines shading factor's intensity due to elevation differences of terrain vertices. It ranges from 0 to 100. - This input is only used for _analysisType = 5 (Hillshade). - If not supplied, default hypsoStrength of 50 will be used.Goo
Refinerefine_Refines the "analysedTerrain" output's mesh to finer resolution (halves the Maximum edge length of the "analysedTerrain" mesh). - Final "analysedTerrain" output is created with a certain mesh resolution. Depending on your terrain, sometimes a mesh resolution of higher precision is required. Be cautious !!! Due to "analysedTerrain" mesh increased number of vertices-faces, setting refine_ to True, can result in much longer component runtime !!! Still if your PC configuration is strong enough, you can always set this input to "True". Except for the _analysisType = 7 (TRI categories). In that case the refine_ input will not make any effect on the final "analysedTerrain" mesh. - If not supplied, the refine_ input will be set to False by default.Goo
Legend Bake ParlegendBakePar_Optional legend parameters from the Gismo "Legend Bake Parameters" component.Goo
_______________Script variable TerrainGenerator2Goo
Bake ItbakeIt_Set to "True" to bake the terrain analysis geometry into the Rhino scene. - If not supplied default value "False" will be used.Goo
Run It_runIt...Goo

Outputs

NameIDDescriptionType
OutreadMe!...String
Analysed TerrainanalysedTerrainAnalysed terrain mesh for the chosen _analysisType.Goo
ValuesvaluesValues corresponding to each "analysedTerrain" vertex, for the chosen _analysisType.Goo
OriginoriginThe origin point of the "analysedTerrain" geometry. It's the same as "_origin" input point. - Use grasshopper's "Point" parameter to visualize it. - Use this point to move the "analysedTerrain" geometry around in the Rhino scene with grasshopper's "Move" component.Goo
TitletitleTitle geometry with information about the chosen analysis type and other inputsGoo
LegendlegendLegend geometry of the "analysedTerrain" output.Goo
Legend PlanelegendPlaneLegend starting plane, which can be used to move the "legend" geometry with grasshopper's "Move" component. - Connect this output to a Grasshopper's "Plane" parameter in order to preview the "legendPlane" plane in the Rhino scene.Goo

Site design © Robin Rodricks.   Gismo and associated data © 2020 Djordje Spasic.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service