HALCON Website / HALCON Operator Reference / Segmentation / Region Growing
ClassesClasses | | Operators

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingN (Operator)

Name

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

Signature

regiongrowing_n(MultiChannelImage : Regions : Metric, MinTolerance, MaxTolerance, MinSize : )

Herror regiongrowing_n(const Hobject MultiChannelImage, Hobject* Regions, const char* Metric, double MinTolerance, double MaxTolerance, const Hlong MinSize)

Herror T_regiongrowing_n(const Hobject MultiChannelImage, Hobject* Regions, const Htuple Metric, const Htuple MinTolerance, const Htuple MaxTolerance, const Htuple MinSize)

void RegiongrowingN(const HObject& MultiChannelImage, HObject* Regions, const HTuple& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, const HTuple& MinSize)

HRegion HImage::RegiongrowingN(const HString& Metric, const HTuple& MinTolerance, const HTuple& MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const HString& Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const char* Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingN(const wchar_t* Metric, double MinTolerance, double MaxTolerance, Hlong MinSize) const   (Windows only)

static void HOperatorSet.RegiongrowingN(HObject multiChannelImage, out HObject regions, HTuple metric, HTuple minTolerance, HTuple maxTolerance, HTuple minSize)

HRegion HImage.RegiongrowingN(string metric, HTuple minTolerance, HTuple maxTolerance, int minSize)

HRegion HImage.RegiongrowingN(string metric, double minTolerance, double maxTolerance, int minSize)

Description

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingN performs a multi-channel regiongrowing. The n 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 [MinToleranceMinToleranceMinToleranceMinToleranceminTolerance, MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance]. Only neighbors of the 4-neighborhood are examined. The following metrics can be used:

Let g_{A} denote the gray value in the feature vector A at point a of the image, and likewise be g_{B} the gray value in the feature vector B at point a neighboring point b. Let g(d) be the gray value with index d. Furthermore, let MinT denote MinToleranceMinToleranceMinToleranceMinToleranceminTolerance and MaxT denote MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance.

'1-norm':

Sum of absolute values

'2-norm':

Euclidian distance

'3-norm':

p - Norm with p = 3

'4-norm':

p - Norm with p = 4

'n-norm':

Minkowski distance

'max-diff':

Supremum distance

'min-diff':

Infimum distance

'variance':

Variance of gray value differences

'dot-product':

Dot product

'correlation':

Correlation

'mean-diff':

Difference of arithmetic means

'mean-ratio':

Ratio of arithmetic means

'length-diff':

Difference of the vector lengths

'length-ratio':

Ratio of the vector lengths

'n-norm-ratio':

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

'gray-max-diff':

Difference of the maximum gray values

'gray-max-ratio':

Ratio of the maximum gray values

'gray-min-diff':

Difference of the minimum gray values

'gray-min-ratio':

Ratio of the minimum gray values

'variance-diff':

Difference of the variances over all gray values (channels)

'variance-ratio':

Ratio of the variances over all gray values (channels)

'mean-abs-diff':

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

'mean-abs-ratio':

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

'max-abs-diff':

Difference of the maximum distance of the components

'max-abs-ratio':

Ratio of the maximum distance of the components

'min-abs-diff':

Difference of the minimum distance of the components

'min-abs-ratio':

Ratio of the minimum distance of the components

'plane':

The following has to hold for all :

Regions with an area less than MinSizeMinSizeMinSizeMinSizeminSize are suppressed.

Execution Information

Parameters

MultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImage (input_object)  (multichannel-)image(-array) → objectHImageHImageHobject (byte)

Input image.

RegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionHobject *

Segmented regions.

MetricMetricMetricMetricmetric (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Metric for the distance of the feature vectors.

Default value: '2-norm' "2-norm" "2-norm" "2-norm" "2-norm"

List of values: '1-norm'"1-norm""1-norm""1-norm""1-norm", '2-norm'"2-norm""2-norm""2-norm""2-norm", '3-norm'"3-norm""3-norm""3-norm""3-norm", '4-norm'"4-norm""4-norm""4-norm""4-norm", 'correlation'"correlation""correlation""correlation""correlation", 'dot-product'"dot-product""dot-product""dot-product""dot-product", 'gray-max-diff'"gray-max-diff""gray-max-diff""gray-max-diff""gray-max-diff", 'gray-max-ratio'"gray-max-ratio""gray-max-ratio""gray-max-ratio""gray-max-ratio", 'gray-min-diff'"gray-min-diff""gray-min-diff""gray-min-diff""gray-min-diff", 'gray-min-ratio'"gray-min-ratio""gray-min-ratio""gray-min-ratio""gray-min-ratio", 'length-diff'"length-diff""length-diff""length-diff""length-diff", 'length-ratio'"length-ratio""length-ratio""length-ratio""length-ratio", 'max-abs-diff'"max-abs-diff""max-abs-diff""max-abs-diff""max-abs-diff", 'max-abs-ratio'"max-abs-ratio""max-abs-ratio""max-abs-ratio""max-abs-ratio", 'max-diff'"max-diff""max-diff""max-diff""max-diff", 'mean-abs-diff'"mean-abs-diff""mean-abs-diff""mean-abs-diff""mean-abs-diff", 'mean-abs-ratio'"mean-abs-ratio""mean-abs-ratio""mean-abs-ratio""mean-abs-ratio", 'mean-diff'"mean-diff""mean-diff""mean-diff""mean-diff", 'mean-ratio'"mean-ratio""mean-ratio""mean-ratio""mean-ratio", 'min-abs-diff'"min-abs-diff""min-abs-diff""min-abs-diff""min-abs-diff", 'min-abs-ratio'"min-abs-ratio""min-abs-ratio""min-abs-ratio""min-abs-ratio", 'min-diff'"min-diff""min-diff""min-diff""min-diff", 'n-norm'"n-norm""n-norm""n-norm""n-norm", 'n-norm-ratio'"n-norm-ratio""n-norm-ratio""n-norm-ratio""n-norm-ratio", 'plane'"plane""plane""plane""plane", 'variance'"variance""variance""variance""variance", 'variance-diff'"variance-diff""variance-diff""variance-diff""variance-diff", 'variance-ratio'"variance-ratio""variance-ratio""variance-ratio""variance-ratio"

MinToleranceMinToleranceMinToleranceMinToleranceminTolerance (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Lower threshold for the features' distance.

Default value: 0.0

Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 12.0, 14.0, 16.0, 18.0, 20.0, 25.0, 30.0

MaxToleranceMaxToleranceMaxToleranceMaxTolerancemaxTolerance (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Upper threshold for the features' distance.

Default value: 20.0

Suggested values: 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 12.0, 14.0, 16.0, 18.0, 20.0, 25.0, 30.0

MinSizeMinSizeMinSizeMinSizeminSize (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Minimum size of the output regions.

Default value: 30

Suggested values: 1, 10, 25, 50, 100, 200, 500, 1000

Typical range of values: 1 ≤ MinSize MinSize MinSize MinSize minSize

Minimum increment: 1

Recommended increment: 5

Result

regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingN 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_systemSetSystemSetSystemSetSystem. If necessary, an exception is raised.

Possible Predecessors

compose2compose2Compose2Compose2Compose2, compose3compose3Compose3Compose3Compose3

Alternatives

class_2dim_supclass_2dim_supClass2dimSupClass2dimSupClass2dimSup, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNorm

See also

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMean

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH