SAGA-GIS Module Library Documentation (v2.3.0)

Module Geodesic Morphological Reconstruction

Geodesic morphological reconstruction according to
L. Vincent (1993): Morphological Grayscale Reconstruction in Image Analysis: Applications and Efficient Algorithms. IEEE Transactions on Image Processing, Vol. 2, No 2
Here we use the algorithm on p. 194: Computing of Regional Maxima and Breadth-first Scanning.

A marker is derived from the input image INPUT_GRID by subtracting a constant SHIFT_VALUE. Optionally the SHIFT_VALUE can be set to zero at the border of the grid ("Preserve 1px border Yes/No"). OUTPUT_GRID is the difference between the input image and the morphological reconstruction of the marker under the input image as mask. If the Option "Create a binary mask" is selected, the OUTPUT_GRID is thresholded with THRESHOLD, creating a binary image of maxima regions.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputInput GridGrid (input)INPUT_GRIDInput for the morphological reconstruction-
OutputObject GridGrid (output)OBJECT_GRIDBinary object mask-
Difference Input - ReconstructionGrid (output)DIFFERENCE_GRIDDifference Input - Reconstruction-
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEMGrid system-
Shift valueFloating pointSHIFT_VALUEShift valueDefault: 5.000000
Preserve 1px border Yes/NoBooleanBORDER_YES_NOPreserve 1px border Yes/NoDefault: 1
Create a binary mask Yes/NoBooleanBIN_YES_NOCreate a binary mask Yes/NoDefault: 1
ThresholdFloating pointTHRESHOLDThresholdDefault: 1.000000

Command-line

Usage: saga_cmd grid_filter 12 [-INPUT_GRID <str>] [-OBJECT_GRID <str>] [-DIFFERENCE_GRID <str>] [-SHIFT_VALUE <double>] [-BORDER_YES_NO <str>] [-BIN_YES_NO <str>] [-THRESHOLD <double>]
  -INPUT_GRID:<str>     	Input Grid
	Grid (input)
  -OBJECT_GRID:<str>    	Object Grid
	Grid (output)
  -DIFFERENCE_GRID:<str>	Difference Input - Reconstruction
	Grid (output)
  -SHIFT_VALUE:<double> 	Shift value
	Floating point
	Default: 5.000000
  -BORDER_YES_NO:<str>  	Preserve 1px border Yes/No
	Boolean
	Default: 1
  -BIN_YES_NO:<str>     	Create a binary mask Yes/No
	Boolean
	Default: 1
  -THRESHOLD:<double>   	Threshold
	Floating point
	Default: 1.000000