SAGA 9.4.2 | Tool Library Documentation

Topographic Openness


Description

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