Name
watersheds_thresholdwatersheds_thresholdWatershedsThresholdwatersheds_thresholdWatershedsThresholdWatershedsThreshold — Extract watershed basins from an image using a threshold.
The operator watersheds_thresholdwatersheds_thresholdWatershedsThresholdwatersheds_thresholdWatershedsThresholdWatershedsThreshold segments regions (basins)
that are separated from each other by a watershed that has a
height of at least ThresholdThresholdThresholdThresholdThresholdthreshold.
In the first step, watersheds_thresholdwatersheds_thresholdWatershedsThresholdwatersheds_thresholdWatershedsThresholdWatershedsThreshold computes the watersheds
without applying a threshold, resulting in the same basins that would be
obtained when calling watershedswatershedsWatershedswatershedsWatershedsWatersheds (for more details please refer to
the description of watershedswatershedsWatershedswatershedsWatershedsWatersheds). In the second step, the basins are
successively merged if they are separated by a watershed that is smaller than
ThresholdThresholdThresholdThresholdThresholdthreshold. Let B1 and B2 be the minimum
gray values of two neighboring basins and W the minimum gray value
of the watershed that separates the two basins. The watershed is eliminated
and the two basins are merged if
max{W-B1,W-B2} < ThresholdThresholdThresholdThresholdThresholdthreshold.
The thus obtained basins are returned in BasinsBasinsBasinsBasinsBasinsbasins.
If ThresholdThresholdThresholdThresholdThresholdthreshold is set to 0, watersheds_thresholdwatersheds_thresholdWatershedsThresholdwatersheds_thresholdWatershedsThresholdWatershedsThreshold is
comparable to watershedswatershedsWatershedswatershedsWatershedsWatersheds except that no watersheds but only expanded
basins are returned. If ThresholdThresholdThresholdThresholdThresholdthreshold is set to the maximum gray value
range of ImageImageImageImageImageimage then no two basins are separated by a watershed
exceeding ThresholdThresholdThresholdThresholdThresholdthreshold, and hence, BasinsBasinsBasinsBasinsBasinsbasins will contain only
one region.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Segments found (dark basins).
Threshold for the watersheds.
Default value: 10
Suggested values: 0, 5, 10, 20, 30, 50
Restriction: Threshold >= 0
watershedswatershedsWatershedswatershedsWatershedsWatersheds always returns 2 (H_MSG_TRUE). The behavior with
respect to the input image and output regions can be determined by
setting the values of the flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result""no_object_result",
'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result""empty_region_result", and 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region"
with set_systemset_systemSetSystemset_systemSetSystemSetSystem. If necessary, an exception is raised.
binomial_filterbinomial_filterBinomialFilterbinomial_filterBinomialFilterBinomialFilter,
gauss_imagegauss_imageGaussImagegauss_imageGaussImageGaussImage,
smooth_imagesmooth_imageSmoothImagesmooth_imageSmoothImageSmoothImage,
invert_imageinvert_imageInvertImageinvert_imageInvertImageInvertImage
expand_regionexpand_regionExpandRegionexpand_regionExpandRegionExpandRegion,
select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape,
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
openingopeningOpeningopeningOpeningOpening
watershedswatershedsWatershedswatershedsWatershedsWatersheds,
pouringpouringPouringpouringPouringPouring
Foundation