Name
label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion — Extract regions with equal gray values from an image.
label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion segments an image into regions of equal
gray value. One output region is generated for each gray value
occurring in the image. This is similar to calling
thresholdthresholdThresholdthresholdThresholdThreshold multiple times, and accumulating the results
with concat_objconcat_objConcatObjconcat_objConcatObjConcatObj. Another related operator is
regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing. However, label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion
does not perform a connectionconnectionConnectionconnectionConnectionConnection operation on the resulting
regions, i.e., they may be disconnected. A typical application of
label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion is the segmentation of label images,
hence its name.
The number of output regions is limited by the system parameter
'max_outp_obj_par', which can be read via
get_system(::'max_outp_obj_par':<number>) .
label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion is not implemented for images of type
'real'. The input images must not contain negative gray values.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Regions having a constant gray value.
Let x1 be the minimum x-coordinate, x2 the maximum x-coordinate,
y1 be the minimum y-coordinate, and y2 the maximum y-coordinate
of a particular gray value. Furthermore, let N be the number of
different gray values in the image. Then the runtime complexity is
O(N * (x2 - x1 + 1) * (y2 - y1 + 1))
label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion returns 2 (H_MSG_TRUE) if the gray values lie
within a correct range. The behavior with respect to the input
images 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.
min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray,
sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp,
binomial_filterbinomial_filterBinomialFilterbinomial_filterBinomialFilterBinomialFilter,
gauss_filtergauss_filterGaussFiltergauss_filterGaussFilterGaussFilter,
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
diff_of_gaussdiff_of_gaussDiffOfGaussdiff_of_gaussDiffOfGaussDiffOfGauss
connectionconnectionConnectionconnectionConnectionConnection,
dilation1dilation1Dilation1dilation1Dilation1Dilation1,
erosion1erosion1Erosion1erosion1Erosion1Erosion1,
openingopeningOpeningopeningOpeningOpening,
closingclosingClosingclosingClosingClosing,
rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion,
shape_transshape_transShapeTransshape_transShapeTransShapeTrans,
skeletonskeletonSkeletonskeletonSkeletonSkeleton
thresholdthresholdThresholdthresholdThresholdThreshold,
concat_objconcat_objConcatObjconcat_objConcatObjConcatObj,
regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing,
region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel
Foundation