regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean (Operator)
Name
regiongrowing_meanregiongrowing_meanRegiongrowingMeanRegiongrowingMeanregiongrowing_mean — Perform a regiongrowing using mean gray values.
Signature
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_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
- 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
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