ClassesClasses | | Operators

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMean (Operator)

Name

regiongrowing_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)

void RegiongrowingMean(const HObject& Image, HObject* Regions, const HTuple& StartRows, const HTuple& StartColumns, const HTuple& Tolerance, const HTuple& MinSize)

HRegion HImage::RegiongrowingMean(const HTuple& StartRows, const HTuple& StartColumns, double Tolerance, Hlong MinSize) const

HRegion HImage::RegiongrowingMean(Hlong StartRows, Hlong StartColumns, double Tolerance, Hlong MinSize) const

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_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMean 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.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  singlechannelimage(-array) objectHImageHImageHobject (byte / uint2 / int4)

Input image.

RegionsRegionsRegionsRegionsregions (output_object)  region-array objectHRegionHRegionHobject *

Segmented regions.

StartRowsStartRowsStartRowsStartRowsstartRows (input_control)  point.y(-array) HTupleHTupleHtuple (integer) (int / long) (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) HTupleHTupleHtuple (integer) (int / long) (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 HTupleHTupleHtuple (real) (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 HTupleHTupleHtuple (integer) (int / long) (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_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMean 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

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusion, median_imagemedian_imageMedianImageMedianImageMedianImage, mean_imagemean_imageMeanImageMeanImageMeanImage

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, openingopeningOpeningOpeningOpening, expand_regionexpand_regionExpandRegionExpandRegionExpandRegion

Alternatives

regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingN

Module

Foundation


ClassesClasses | | Operators