SAGA 9.12.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
Processing Buffer Distancefloating point numberPROC_BUFFERWidth of the buffer added around the central raster area [map units]. Tracing is performed across the full buffered extent, but openness is calculated only for the inner (non-buffered) area. The buffer distance should match or exceed the radial limit to avoid edge effects.Minimum: 0.000000 Default: 0.000000

Command Line


Usage: saga_cmd ta_lighting 5 [-DEM ] [-POS ] [-NEG ] [-RADIUS ] [-DIRECTIONS ] [-DIRECTION ] [-NDIRS ] [-METHOD ] [-DLEVEL ] [-UNIT ] [-NADIR ] [-PROC_BUFFER ]
  -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
  -PROC_BUFFER:   Processing Buffer Distance
	floating point number
	Minimum: 0.000000
	Default: 0.000000