SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Terrain Map View

This tool allows one to create different terrain visualisations from an elevation dataset:

* Topography: a simple map with an analytical hillshading of the terrain

* Morphology: a map which visualizes the terrain by combining positive and negative openness (Yokoyama et al. 2002) with terrain slope in a single map. In contrast to conventional shading methods this has the advantage of being independent from the direction of the light source.

References:
Yokoyama, R. / Shirasawa, M. / Pike, R.J. (2002): Visualizing topography by openness: A new application of image processing to digital elevation models. Photogrammetric Engineering and Remote Sensing, Vol.68, pp.251-266. online at ASPRS.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputDEMgrid, inputDEMDigital elevation model.-
OutputShade (*)grid, output, optionalSHADEThe shaded DTM.-
Openness (*)grid, output, optionalOPENNESSThe difference of positive and negative openness.-
Slope (*)grid, output, optionalSLOPEThe calculated terrain slope [radians].-
Contours (*)shapes, output, optionalCONTOURSThe generated contour lines.-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
MethodchoiceMETHODChoose the map type to generate.Available Choices:
[0] Topography
[1] Morphology
Default: 0
Radial Limitfloating point numberRADIUSRadial search limit for openness calculation.Minimum: 0.000000
Default: 1000.000000
Contour LinesbooleanCONTOUR_LINESDerive contour lines.Default: 1
Equidistancefloating point numberEQUIDISTANCEContour lines equidistance [map units].Minimum: 0.000000
Default: 50.000000
(*) optional

Command-line

Usage: saga_cmd grid_visualisation 8 [-DEM <str>] [-SHADE <str>] [-OPENNESS <str>] [-SLOPE <str>] [-CONTOURS <str>] [-METHOD <str>] [-RADIUS <double>] [-CONTOUR_LINES <str>] [-EQUIDISTANCE <double>]
  -DEM:<str>            	DEM
	grid, input
  -SHADE:<str>          	Shade
	grid, output, optional
  -OPENNESS:<str>       	Openness
	grid, output, optional
  -SLOPE:<str>          	Slope
	grid, output, optional
  -CONTOURS:<str>       	Contours
	shapes, output, optional
  -METHOD:<str>         	Method
	choice
	Available Choices:
	[0] Topography
	[1] Morphology
	Default: 0
  -RADIUS:<double>      	Radial Limit
	floating point number
	Minimum: 0.000000
	Default: 1000.000000
  -CONTOUR_LINES:<str>  	Contour Lines
	boolean
	Default: 1
  -EQUIDISTANCE:<double>	Equidistance
	floating point number
	Minimum: 0.000000
	Default: 50.000000