Skip to content

noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMeannoise_distribution_meanT_noise_distribution_mean🔗

Short description🔗

noise_distribution_meannoise_distribution_meanNoiseDistributionMeanNoiseDistributionMeannoise_distribution_meanT_noise_distribution_mean — Determine the noise distribution of an image.

Signature🔗

noise_distribution_mean( region ConstRegion, image Image, integer FilterSize, out distribution.values Distribution )noise_distribution_mean( ConstRegion, Image : : FilterSize : Distribution )void NoiseDistributionMean( const HObject& ConstRegion, const HObject& Image, const HTuple& FilterSize, HTuple* Distribution )static void HOperatorSet.NoiseDistributionMean( HObject constRegion, HObject image, HTuple filterSize, out HTuple distribution )def noise_distribution_mean( const_region: HObject, image: HObject, filter_size: int ) -> Sequence[float]

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

HTuple HImage::NoiseDistributionMean( const HRegion& ConstRegion, Hlong FilterSize ) const

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

HTuple HImage.NoiseDistributionMean( HRegion constRegion, int filterSize )

HTuple HRegion.NoiseDistributionMean( HImage image, int filterSize )

Description🔗

noise_distribution_meanNoiseDistributionMean calculates the noise distribution in a region of the image Imageimageimage. The parameter ConstRegionconstRegionconst_region 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_imageMeanImage 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 Distributiondistributiondistribution.

Attention🔗

It is important to ensure that the region ConstRegionconstRegionconst_region 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 ConstRegionconstRegionconst_region must be at least as large as the filter size FilterSizefilterSizefilter_size used for calculating the mean.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

ConstRegionconstRegionconst_region (input_object) region(-array) → objectobjectHObjectHRegionHObjectHobject

Region from which the noise distribution is to be estimated.

Imageimageimage (input_object) singlechannelimage → object (byte)object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject (byte)

Corresponding image.

FilterSizefilterSizefilter_size (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Size of the mean filter.

Default: 2121
Suggested values: 5, 11, 15, 21, 31, 51, 1015, 11, 15, 21, 31, 51, 101
Value range: 3 ≤ FilterSize ≤ 501 (lin)
Minimum increment: 2
Recommended increment: 2

Distributiondistributiondistribution (output_control) distribution.values-array → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Noise distribution of all input regions.

Combinations with other operators🔗

Combinations

Possible predecessors

draw_regionDrawRegion, gen_circleGenCircle, gen_ellipseGenEllipse, gen_rectangle1GenRectangle1, gen_rectangle2GenRectangle2, thresholdThreshold, erosion_circleErosionCircle, binomial_filterBinomialFilter, gauss_filterGaussFilter, smooth_imageSmoothImage, sub_imageSubImage

Possible successors

add_noise_distributionAddNoiseDistribution

See also

mean_imageMeanImage, gauss_distributionGaussDistribution

Module🔗

Foundation