SAGA 9.3.3 | Tool Library Documentation

DTM Filter (slope-based)


Description

The tool can be used to filter a digital elevation model in order to classify its cells into bare earth and object cells (ground and non-ground cells). The tool uses concepts as described by Vosselman (2000) and is based on the assumption that a large height difference between two nearby cells is unlikely to be caused by a steep slope in the terrain. The probability that the higher cell might be non-ground increases when the distance between the two cells decreases. Therefore the filter defines a maximum height difference (dz_max) between two cells as a function of the distance (d) between the cells (dz_max(d) = d). A cell is classified as terrain if there is no cell within the kernel radius to which the height difference is larger than the allowed maximum height difference at the distance between these two cells. The approximate terrain slope (s) parameter is used to modify the filter function to match the overall slope in the study area (dz_max(d) = d * s). A 5% confidence interval (ci = 1.65 * sqrt(2 * stddev)) may be used to modify the filter function even further by either relaxing (dz_max(d) = d * s + ci) or amplifying (dz_max(d) = d * s - ci) the filter criterium.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputDEMgrid, inputINPUTThe grid to filter.-
OutputBare Earthgrid, outputGROUNDThe filtered DEM containing only cells classified as ground.-
Removed Objectsgrid, output, optionalNONGROUNDThe non-ground objects removed by the filter.-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Kernel Radiusinteger numberRADIUSThe radius of the filter kernel [grid cells]. Must be large enough to reach ground cells next to non-ground objects.Minimum: 1 Default: 5
Terrain Slope [%]floating point numberTERRAINSLOPEThe approximate terrain slope [%]. Used to relax the filter criterium in steeper terrain.Minimum: 0.000000 Default: 30.000000
Filter ModificationchoiceFILTERMODChoose whether to apply the filter kernel without modification or to use a confidence interval to relax or amplify the height criterium.Available Choices: [0] none [1] relax filter [2] amplify filter Default: 0
Standard Deviationfloating point numberSTDDEVThe standard deviation used to calculate a 5% confidence interval applied to the height threshold [map units].Minimum: 0.000000 Default: 0.100000

Command Line


Usage: saga_cmd grid_filter 7 [-INPUT ] [-GROUND ] [-NONGROUND ] [-RADIUS ] [-TERRAINSLOPE ] [-FILTERMOD ] [-STDDEV ]
  -INPUT:          	DEM
	grid, input
  -GROUND:         	Bare Earth
	grid, output
  -NONGROUND:      	Removed Objects
	grid, output, optional
  -RADIUS:         	Kernel Radius
	integer number
	Minimum: 1
	Default: 5
  -TERRAINSLOPE:	Terrain Slope [%]
	floating point number
	Minimum: 0.000000
	Default: 30.000000
  -FILTERMOD:      	Filter Modification
	choice
	Available Choices:
	[0] none
	[1] relax filter
	[2] amplify filter
	Default: 0
  -STDDEV:      	Standard Deviation
	floating point number
	Minimum: 0.000000
	Default: 0.100000