SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Topographic Openness

Topographic openness expresses the dominance (positive) or enclosure (negative) of a landscape location. See Yokoyama et al. (2002) for a precise definition. Openness has been related to how wide a landscape can be viewed from any position. It has been proven to be a meaningful input for computer aided geomorphological mapping.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputDEM--
OutputPositive Opennessgrid, outputPOS--
Negative Opennessgrid, outputNEG--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Radial Limitfloating point numberRADIUSMaximum search distance [map units].Minimum: 0.000000
Default: 10000.000000
DirectionschoiceDIRECTIONS-Available Choices:
[0] single
[1] all
Default: 1
Directionfloating point numberDIRECTIONSingle direction given as degree measured clockwise from the North direction.Minimum: -360.000000
Maximum: 360.000000
Default: 315.000000
Number of Sectorsinteger numberNDIRS-Minimum: 4
Default: 8
MethodchoiceMETHOD-Available Choices:
[0] multi scale
[1] line tracing
Default: 1
Multi Scale Factorfloating point numberDLEVEL-Minimum: 1.250000
Default: 3.000000
UnitchoiceUNIT-Available Choices:
[0] Radians
[1] Degree
Default: 0
Difference from NadirbooleanNADIRIf set, output angles are the mean difference from nadir, or else from a plane.Default: 1

Command-line

Usage: saga_cmd ta_lighting 5 [-DEM <str>] [-POS <str>] [-NEG <str>] [-RADIUS <double>] [-DIRECTIONS <str>] [-DIRECTION <double>] [-NDIRS <num>] [-METHOD <str>] [-DLEVEL <double>] [-UNIT <str>] [-NADIR <str>]
  -DEM:<str>         	Elevation
	grid, input
  -POS:<str>         	Positive Openness
	grid, output
  -NEG:<str>         	Negative Openness
	grid, output
  -RADIUS:<double>   	Radial Limit
	floating point number
	Minimum: 0.000000
	Default: 10000.000000
  -DIRECTIONS:<str>  	Directions
	choice
	Available Choices:
	[0] single
	[1] all
	Default: 1
  -DIRECTION:<double>	Direction
	floating point number
	Minimum: -360.000000
	Maximum: 360.000000
	Default: 315.000000
  -NDIRS:<num>       	Number of Sectors
	integer number
	Minimum: 4
	Default: 8
  -METHOD:<str>      	Method
	choice
	Available Choices:
	[0] multi scale
	[1] line tracing
	Default: 1
  -DLEVEL:<double>   	Multi Scale Factor
	floating point number
	Minimum: 1.250000
	Default: 3.000000
  -UNIT:<str>        	Unit
	choice
	Available Choices:
	[0] Radians
	[1] Degree
	Default: 0
  -NADIR:<str>       	Difference from Nadir
	boolean
	Default: 1