regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean (Operator)

Name

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean — 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)

def regiongrowing_mean(image: HObject, start_rows: MaybeSequence[int], start_columns: MaybeSequence[int], tolerance: float, min_size: int) -> HObject

Description

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean performs a regiongrowing using the mean gray values of a region, starting from points given by StartRowsStartRowsStartRowsStartRowsstartRowsstart_rows and StartColumnsStartColumnsStartColumnsStartColumnsstartColumnsstart_columns. 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 ToleranceToleranceToleranceTolerancetolerancetolerance. Regions smaller than MinSizeMinSizeMinSizeMinSizeminSizemin_size 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

ImageImageImageImageimageimage (input_object)  singlechannelimage(-array) objectHImageHObjectHImageHobject (byte / uint2 / int4)

Input image.

RegionsRegionsRegionsRegionsregionsregions (output_object)  region-array objectHRegionHObjectHRegionHobject *

Segmented regions.

StartRowsStartRowsStartRowsStartRowsstartRowsstart_rows (input_control)  point.y(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinates of the starting points.

Default value: []

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

Minimum increment: 1

Recommended increment: 1

StartColumnsStartColumnsStartColumnsStartColumnsstartColumnsstart_columns (input_control)  point.x(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinates of the starting points.

Default value: []

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

Minimum increment: 1

Recommended increment: 1

ToleranceToleranceToleranceTolerancetolerancetolerance (input_control)  number HTuplefloatHTupleHtuple (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

MinSizeMinSizeMinSizeMinSizeminSizemin_size (input_control)  integer HTupleintHTupleHtuple (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 min_size

Minimum increment: 1

Recommended increment: 100

Restriction: MinSize >= 0

Result

regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean 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""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_systemSetSystemSetSystemSetSystemset_system. If necessary, an exception is raised.

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImagesigma_image, anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusionanisotropic_diffusion, median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image, mean_imagemean_imageMeanImageMeanImageMeanImagemean_image

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, openingopeningOpeningOpeningOpeningopening, expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region

Alternatives

regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, regiongrowing_nregiongrowing_nRegiongrowingNRegiongrowingNRegiongrowingNregiongrowing_n

Module

Foundation