regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNregiongrowing_n (Operator)

Name

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNregiongrowing_n — Segment an image using regiongrowing for multi-channel images.

Signature

Description

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNregiongrowing_n performs a multi-channel regiongrowing. The channels give rise to an n-dimensional feature vector. Neighboring points are aggregated into the same region if the difference of their feature vectors with respect to the given metric lies in the interval [MinToleranceMinToleranceMinToleranceminTolerancemin_tolerance, MaxToleranceMaxToleranceMaxTolerancemaxTolerancemax_tolerance]. Only neighbors of the 4-neighborhood are examined. The following metrics can be used:

Let denote the gray value in the feature vector at point of the image, and likewise be the gray value in the feature vector at point a neighboring point . Let be the gray value with index . Furthermore, let denote MinToleranceMinToleranceMinToleranceminTolerancemin_tolerance and denote MaxToleranceMaxToleranceMaxTolerancemaxTolerancemax_tolerance.

'1-norm'"1-norm""1-norm""1-norm""1-norm":

Sum of absolute values

'2-norm'"2-norm""2-norm""2-norm""2-norm":

Euclidean distance

'3-norm'"3-norm""3-norm""3-norm""3-norm":

p - Norm with p = 3

'4-norm'"4-norm""4-norm""4-norm""4-norm":

p - Norm with p = 4

'n-norm'"n-norm""n-norm""n-norm""n-norm":

Minkowski distance

'max-diff'"max-diff""max-diff""max-diff""max-diff":

Supremum distance

'min-diff'"min-diff""min-diff""min-diff""min-diff":

Infimum distance

'variance'"variance""variance""variance""variance":

Variance of gray value differences

'dot-product'"dot-product""dot-product""dot-product""dot-product":

Dot product

'correlation'"correlation""correlation""correlation""correlation":

Correlation

'mean-diff'"mean-diff""mean-diff""mean-diff""mean-diff":

Difference of arithmetic means

'mean-ratio'"mean-ratio""mean-ratio""mean-ratio""mean-ratio":

Ratio of arithmetic means

'length-diff'"length-diff""length-diff""length-diff""length-diff":

Difference of the vector lengths

'length-ratio'"length-ratio""length-ratio""length-ratio""length-ratio":

Ratio of the vector lengths

'n-norm-ratio'"n-norm-ratio""n-norm-ratio""n-norm-ratio""n-norm-ratio":

Ratio of the vector lengths w.r.t the p-norm with p = n

'gray-max-diff'"gray-max-diff""gray-max-diff""gray-max-diff""gray-max-diff":

Difference of the maximum gray values

'gray-max-ratio'"gray-max-ratio""gray-max-ratio""gray-max-ratio""gray-max-ratio":

Ratio of the maximum gray values

'gray-min-diff'"gray-min-diff""gray-min-diff""gray-min-diff""gray-min-diff":

Difference of the minimum gray values

'gray-min-ratio'"gray-min-ratio""gray-min-ratio""gray-min-ratio""gray-min-ratio":

Ratio of the minimum gray values

'variance-diff'"variance-diff""variance-diff""variance-diff""variance-diff":

Difference of the variances over all gray values (channels)

'variance-ratio'"variance-ratio""variance-ratio""variance-ratio""variance-ratio":

Ratio of the variances over all gray values (channels)

'mean-abs-diff'"mean-abs-diff""mean-abs-diff""mean-abs-diff""mean-abs-diff":

Difference of the sum of absolute values over all gray values (channels)

'mean-abs-ratio'"mean-abs-ratio""mean-abs-ratio""mean-abs-ratio""mean-abs-ratio":

Ratio of the sum of absolute values over all gray values (channels)

'max-abs-diff'"max-abs-diff""max-abs-diff""max-abs-diff""max-abs-diff":

Difference of the maximum distance of the components

'max-abs-ratio'"max-abs-ratio""max-abs-ratio""max-abs-ratio""max-abs-ratio":

Ratio of the maximum distance of the components

'min-abs-diff'"min-abs-diff""min-abs-diff""min-abs-diff""min-abs-diff":

Difference of the minimum distance of the components

'min-abs-ratio'"min-abs-ratio""min-abs-ratio""min-abs-ratio""min-abs-ratio":

Ratio of the minimum distance of the components

'plane'"plane""plane""plane""plane":

The following has to hold for all :

Regions with an area less than MinSizeMinSizeMinSizeminSizemin_size are suppressed.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

Result

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNregiongrowing_n returns 2 ( H_MSG_TRUE) if all parameters are correct. 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", '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" with set_systemset_systemSetSystemSetSystemset_system. If necessary, an exception is raised.

Possible Predecessors

compose2compose2Compose2Compose2compose2, compose3compose3Compose3Compose3compose3

Alternatives

class_2dim_supclass_2dim_supClass2dimSupClass2dimSupclass_2dim_sup, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

See also

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean

Module

Foundation