HALCON Reference Manual 10.0.2
Table of Contents / Segmentation / Region Growing ClassesClassesClasses | | | Operators

regiongrowing_meanregiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMean (Operator)

Name

regiongrowing_meanregiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMean — Perform a regiongrowing using mean gray values.

Signature

regiongrowing_mean(Image : Regions : StartRows, StartColumns, Tolerance, MinSize : )

Herror regiongrowing_mean(const Hobject Image, Hobject* Regions, const Hlong StartRows, const Hlong StartColumns, double Tolerance, const Hlong MinSize)

Herror T_regiongrowing_mean(const Hobject Image, Hobject* Regions, const Htuple StartRows, const Htuple StartColumns, const Htuple Tolerance, const Htuple MinSize)

Herror regiongrowing_mean(Hobject Image, Hobject* Regions, const HTuple& StartRows, const HTuple& StartColumns, const HTuple& Tolerance, const HTuple& MinSize)

HRegionArray HImage::RegiongrowingMean(const HTuple& StartRows, const HTuple& StartColumns, const HTuple& Tolerance, const HTuple& MinSize) const

HRegionArray HImageArray::RegiongrowingMean(const HTuple& StartRows, const HTuple& StartColumns, const HTuple& Tolerance, const HTuple& MinSize) const

void HOperatorSetX.RegiongrowingMean(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** Regions, [in] VARIANT StartRows, [in] VARIANT StartColumns, [in] VARIANT Tolerance, [in] VARIANT MinSize)

IHRegionX* HImageX.RegiongrowingMean(
[in] VARIANT StartRows, [in] VARIANT StartColumns, [in] double Tolerance, [in] Hlong MinSize)

static void HOperatorSet.RegiongrowingMean(HObject image, out HObject regions, HTuple startRows, HTuple startColumns, HTuple tolerance, HTuple minSize)

HRegion HImage.RegiongrowingMean(HTuple startRows, HTuple startColumns, double tolerance, int minSize)

HRegion HImage.RegiongrowingMean(int startRows, int startColumns, double tolerance, int minSize)

Description

regiongrowing_meanregiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMean performs a regiongrowing using the mean gray values of a region, starting from points given by StartRowsStartRowsStartRowsStartRowsstartRows and StartColumnsStartColumnsStartColumnsStartColumnsstartColumns. At any point in the process the mean gray value of the current region is calculated. Gray values at the boundary of the region are added to the region if they differ from the current mean by less than ToleranceToleranceToleranceTolerancetolerance. Regions smaller than MinSizeMinSizeMinSizeMinSizeminSize are suppressed.

If no starting points are given (empty tuples), the expansion process starts at the upper leftmost point, and is continued with the first unprocessed point after a region has been created.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  image(-array) → objectHImageHImageHImageXHobject (byte / uint2 / int4)

Input image.

RegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionArrayHRegionXHobject *

Segmented regions.

StartRowsStartRowsStartRowsStartRowsstartRows (input_control)  point.y(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points.

Default value: []

Typical range of values: 0 ≤ StartRows StartRows StartRows StartRows startRows

Minimum increment: 1

Recommended increment: 1

StartColumnsStartColumnsStartColumnsStartColumnsstartColumns (input_control)  point.x(-array) → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points.

Default value: []

Typical range of values: 0 ≤ StartColumns StartColumns StartColumns StartColumns startColumns

Minimum increment: 1

Recommended increment: 1

ToleranceToleranceToleranceTolerancetolerance (input_control)  number → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Maximum deviation from the mean.

Default value: 5.0

Suggested values: 0.5, 1.0, 1.5, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 12.0, 15.0, 17.0, 20.0, 25.0, 30.0, 40.0

Restriction: Tolerance > 0.0

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

Minimum size of a region.

Default value: 100

Suggested values: 0, 10, 30, 50, 100, 500, 1000, 2000

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

Minimum increment: 1

Recommended increment: 100

Restriction: MinSize >= 0

Result

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

Possible Predecessors

binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage, anisotropic_diffusionanisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusion, median_imagemedian_imagemedian_imageMedianImageMedianImage, mean_imagemean_imagemean_imageMeanImageMeanImage

Possible Successors

select_shapeselect_shapeselect_shapeSelectShapeSelectShape, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, openingopeningopeningOpeningOpening, expand_regionexpand_regionexpand_regionExpandRegionExpandRegion

Alternatives

regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, regiongrowing_nregiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingN

Module

Foundation

Table of Contents / Segmentation / Region Growing ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH