SAGA-GIS Tool Library Documentation (v8.1.0)

Tool Ground Classification

The tool allows one to filter a point cloud into ground (bare earth) and non-ground points. The ground points can be used later to create a digital elevation model from the data, for example.
The tool uses concepts as described by Vosselman (2000) and is based on the assumption that a large height difference between two nearby points is unlikely to be caused by a steep slope in the terrain. The probability that the higher point might be non-ground increases when the distance between the two points decreases. Therefore the filter defines a maximum height difference (dz_max) between two points as a function of the distance (d) between the points (dz_max(d) = d). A point is classified as terrain if there is no other point within the kernel radius to which the height difference is larger than the allowed maximum height difference at the distance between these two points.
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
InputPoint CloudPoint Cloud, inputPC_INThe input point cloud to classify.-
OutputPoint Cloud Classified (*)Point Cloud, output, optionalPC_OUTThe classified point cloud.-
OptionsFilter RadiusFloating pointRADIUSThe radius of the filter kernel [map units]. Must be large enough to reach ground points next to non-ground objects.Minimum: 0.001000
Default: 2.500000
Terrain Slope [%]Floating pointTERRAINSLOPEThe 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 pointSTDDEVThe standard deviation used to calculate a 5% confidence interval applied to the height threshold [map units].Minimum: 0.000000
Default: 0.100000
(*) optional

Command-line

Usage: saga_cmd pointcloud_tools 15 [-PC_IN <str>] [-PC_OUT <str>] [-RADIUS <double>] [-TERRAINSLOPE <double>] [-FILTERMOD <str>] [-STDDEV <double>]
  -PC_IN:<str>          	Point Cloud
	Point Cloud, input
  -PC_OUT:<str>         	Point Cloud Classified
	Point Cloud, output, optional
  -RADIUS:<double>      	Filter Radius
	Floating point
	Minimum: 0.001000
	Default: 2.500000
  -TERRAINSLOPE:<double>	Terrain Slope []
	Floating point
	Minimum: 0.000000
	Default: 30.000000
  -FILTERMOD:<str>      	Filter Modification
	Choice
	Available Choices:
	[0] none
	[1] relax filter
	[2] amplify filter
	Default: 0
  -STDDEV:<double>      	Standard Deviation
	Floating point
	Minimum: 0.000000
	Default: 0.100000