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

mean_spmean_spmean_spMeanSpMeanSp (Operator)

Name

mean_spmean_spmean_spMeanSpMeanSp — Suppress salt and pepper noise.

Signature

mean_sp(Image : ImageSPMean : MaskWidth, MaskHeight, MinThresh, MaxThresh : )

Herror mean_sp(const Hobject Image, Hobject* ImageSPMean, const Hlong MaskWidth, const Hlong MaskHeight, const Hlong MinThresh, const Hlong MaxThresh)

Herror T_mean_sp(const Hobject Image, Hobject* ImageSPMean, const Htuple MaskWidth, const Htuple MaskHeight, const Htuple MinThresh, const Htuple MaxThresh)

Herror mean_sp(Hobject Image, Hobject* ImageSPMean, const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& MinThresh, const HTuple& MaxThresh)

HImage HImage::MeanSp(const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& MinThresh, const HTuple& MaxThresh) const

HImageArray HImageArray::MeanSp(const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& MinThresh, const HTuple& MaxThresh) const

void HOperatorSetX.MeanSp(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** ImageSPMean, [in] VARIANT MaskWidth, [in] VARIANT MaskHeight, [in] VARIANT MinThresh, [in] VARIANT MaxThresh)

IHImageX* HImageX.MeanSp(
[in] Hlong MaskWidth, [in] Hlong MaskHeight, [in] Hlong MinThresh, [in] Hlong MaxThresh)

static void HOperatorSet.MeanSp(HObject image, out HObject imageSPMean, HTuple maskWidth, HTuple maskHeight, HTuple minThresh, HTuple maxThresh)

HImage HImage.MeanSp(int maskWidth, int maskHeight, int minThresh, int maxThresh)

Description

The operator mean_spmean_spmean_spMeanSpMeanSp carries out a smoothing by averaging the values. Only the gray values within the interval from MinThreshMinThreshMinThreshMinThreshminThresh to MaxThreshMaxThreshMaxThreshMaxThreshmaxThresh are averaged. Gray values which are too light or too dark are ignored during summation. If no gray value lies within the default interval during summation the original gray value is adopted. If the thresholds are set at 0 or 255, respectively, the operator mean_spmean_spmean_spMeanSpMeanSp behaves like mean_imagemean_imagemean_imageMeanImageMeanImage except for the running time.

The operator mean_spmean_spmean_spMeanSpMeanSp is used to suppress extreme gray values (salt and pepper noise = white and black dots).

Attention

If even values instead of odd values are given for MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight or MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth, the routine uses the next larger odd values instead (this way the center of the filter mask is always explicitly determined).

Parallelization

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject (byte / uint2)

Input image.

ImageSPMeanImageSPMeanImageSPMeanImageSPMeanimageSPMean (output_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject * (byte / uint2)

Smoothed image.

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Width of filter mask.

Default value: 3

Suggested values: 3, 5, 7, 9, 11

Typical range of values: 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth ≤ 512 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskWidth)

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Height of filter mask.

Default value: 3

Suggested values: 3, 5, 7, 9, 11

Typical range of values: 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight ≤ 512 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: odd(MaskHeight)

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

Minimum gray value.

Default value: 1

Suggested values: 1, 5, 7, 9, 11, 15, 23, 31, 43, 61, 101

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

Maximum gray value.

Default value: 254

Suggested values: 5, 7, 9, 11, 15, 23, 31, 43, 61, 101, 200, 230, 250, 254

Restriction: MinThresh <= MaxThresh

Example (HDevelop)

read_image(Image,'mreut')
disp_image(Image,WindowHandle)
mean_sp(Image,ImageMeansp,3,3,101,201)
disp_image(ImageMeansp,WindowHandle)

Example (C)

read_image(&Image,"mreut");
disp_image(Image,WindowHandle);
mean_sp(Image,&ImageMeansp,3,3,101,201);
disp_image(ImageMeansp,WindowHandle);

Example (HDevelop)

read_image(Image,'mreut')
disp_image(Image,WindowHandle)
mean_sp(Image,ImageMeansp,3,3,101,201)
disp_image(ImageMeansp,WindowHandle)

Example (HDevelop)

read_image(Image,'mreut')
disp_image(Image,WindowHandle)
mean_sp(Image,ImageMeansp,3,3,101,201)
disp_image(ImageMeansp,WindowHandle)

Example (HDevelop)

read_image(Image,'mreut')
disp_image(Image,WindowHandle)
mean_sp(Image,ImageMeansp,3,3,101,201)
disp_image(ImageMeansp,WindowHandle)

Possible Successors

disp_imagedisp_imagedisp_imageDispImageDispImage

Alternatives

mean_imagemean_imagemean_imageMeanImageMeanImage, median_imagemedian_imagemedian_imageMedianImageMedianImage, median_separatemedian_separatemedian_separateMedianSeparateMedianSeparate, eliminate_min_maxeliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMax

See also

anisotropic_diffusionanisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusion, sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage, binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage, eliminate_min_maxeliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMax

Module

Foundation

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