HALCON Reference Manual 10.0.2
Table of Contents / Filters / Noise ClassesClassesClasses | | | Operators

noise_distribution_meanT_noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMean (Operator)

Name

noise_distribution_meanT_noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMean — Determine the noise distribution of an image.

Signature

noise_distribution_mean(ConstRegion, Image : : FilterSize : Distribution)

Herror T_noise_distribution_mean(const Hobject ConstRegion, const Hobject Image, const Htuple FilterSize, Htuple* Distribution)

Herror noise_distribution_mean(Hobject ConstRegion, Hobject Image, const HTuple& FilterSize, HTuple* Distribution)

HTuple HRegion::NoiseDistributionMean(const HImage& Image, const HTuple& FilterSize) const

HTuple HRegionArray::NoiseDistributionMean(const HImage& Image, const HTuple& FilterSize) const

void HOperatorSetX.NoiseDistributionMean(
[in] IHUntypedObjectX* ConstRegion, [in] IHUntypedObjectX* Image, [in] VARIANT FilterSize, [out] VARIANT* Distribution)

VARIANT HImageX.NoiseDistributionMean(
[in] IHRegionX* ConstRegion, [in] Hlong FilterSize)

VARIANT HRegionX.NoiseDistributionMean(
[in] IHImageX* Image, [in] Hlong FilterSize)

static void HOperatorSet.NoiseDistributionMean(HObject constRegion, HObject image, HTuple filterSize, out HTuple distribution)

HTuple HImage.NoiseDistributionMean(HRegion constRegion, int filterSize)

HTuple HRegion.NoiseDistributionMean(HImage image, int filterSize)

Description

noise_distribution_meannoise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMean calculates the noise distribution in a region of the image ImageImageImageImageimage. The parameter ConstRegionConstRegionConstRegionConstRegionconstRegion determines a region of the image with approximately constant gray values. Ideally, the changes in gray values should only be caused by noise in this region. From this region the noise distribution is determined by using the mean_imagemean_imagemean_imageMeanImageMeanImage operator to smooth the image, and to use the gray value differences in this area as an estimate for the noise distribution, which is returned in DistributionDistributionDistributionDistributiondistribution.

Attention

It is important to ensure that the region ConstRegionConstRegionConstRegionConstRegionconstRegion is not too close to a large gradient in the image, because the gradient values are then used for calculating the mean. This means the distance of ConstRegionConstRegionConstRegionConstRegionconstRegion must be at least as large as the filter size FilterSizeFilterSizeFilterSizeFilterSizefilterSize used for calculating the mean.

Parallelization

Parameters

ConstRegionConstRegionConstRegionConstRegionconstRegion (input_object)  region(-array) → objectHRegionHRegionHRegionXHobject

Region from which the noise distribution is to be estimated.

ImageImageImageImageimage (input_object)  image → objectHImageHImageHImageXHobject (byte)

Corresponding image.

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

Size of the mean filter.

Default value: 21

Suggested values: 5, 11, 15, 21, 31, 51, 101

Typical range of values: 3 ≤ FilterSize FilterSize FilterSize FilterSize filterSize ≤ 501 (lin)

Minimum increment: 2

Recommended increment: 2

DistributionDistributionDistributionDistributiondistribution (output_control)  distribution.values-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Noise distribution of all input regions.

Possible Predecessors

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion, gen_circlegen_circlegen_circleGenCircleGenCircle, gen_ellipsegen_ellipsegen_ellipseGenEllipseGenEllipse, gen_rectangle1gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1, gen_rectangle2gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2, thresholdthresholdthresholdThresholdThreshold, erosion_circleerosion_circleerosion_circleErosionCircleErosionCircle, binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage, sub_imagesub_imagesub_imageSubImageSubImage

Possible Successors

add_noise_distributionadd_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistribution, disp_distributiondisp_distributiondisp_distributionDispDistributionDispDistribution

See also

mean_imagemean_imagemean_imageMeanImageMeanImage, gauss_distributiongauss_distributiongauss_distributionGaussDistributionGaussDistribution

Module

Foundation

Table of Contents / Filters / Noise ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH