Variable threshold computation

Command line

The Variable threshold computation operation can be directly executed by typing the following expression on the command line of the Main window:

  

OUTMAP

=

MapVariableThresholdComputation(InputMapName, FilterSize, NrOfClasses, "UpperBounds_and_ThresholdVals", InternalReliefMap)

where:

OUTMAP

is the name of the output raster map.

MapVariableThresholdComputation

is the command to start the Variable threshold computation operation.

InputMapName

is the name of the input raster map (value domain); the input raster map is expected to be a Digital Elevation Model (DEM).

To use a value attribute column from an attribute table which is linked to a raster map with a Class or an ID domain, use InputMapName.ColumnName

FilterSize

is a value for the size of the window that will move over the map(s); filter size 3, means that each time 3 x 3 input pixels are considered.

NrOfClasses

is a parameter to specify the number of classes that you wish to obtain in the output threshold map (1 integer value 5)

"UpperBounds_and_ThresholdVals"

is a string in which, for each class at a time, the upper boundary value for internal relief values is specified, followed by the desired output threshold value. Boundary values and threshold values are separated by commas, this is repeated for each output 'class'; the total string needs to be surrounded by double quotes.

When using for instance 2 classes, the string could read: "25, 750, 75, 250, 500, 100"

In this example, values 25, 75 and 500 are the upper boundary values for the internal relief; values 750, 250, and 100 are the respective threshold values that will be assigned to these classes.

InternalReliefMap

true | false | 1 | 0

Specify true or 1 when you wish to obtain an output raster map with internal relief values. The internal relief map will obtain the same name as the output threshold map, followed by __1.

Specify false or 0 when no internal relief map is required.

When the definition symbol = is used, a dependent output map is created; when the assignment symbol := is used, the dependency link is immediately broken after the output map has been calculated.

Example:

To perform the Variable threshold operation on height map MyFilledDEM,

 

you can use the following expression:

 

OUTMAP

=

MapVariableThresholdComputation(MyFilledDEM,5,3,"30,1000,80,250,500,50", 1)

See also: