sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage (Operator)

Name

sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage — Non-linear smoothing with the sigma filter.

Signature

Description

The operator sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage carries out a non-linear smoothing of the gray values of all input images (ImageImageImageImageimage). All pixels in a rectangular window (MaskHeight x MaskWidth) are used to determine the new gray value of the central pixel of this window. First, the gray value standard deviation of all pixels in the window is calculated. Then, all pixels of the window with a gray value that differs from the gray value of the central pixel by less than SigmaSigmaSigmaSigmasigma times this standard deviation are used to calculate the new gray value of the central pixel. The gray value of the central pixel is the average of the gray values of the selected pixels. If no pixel could be selected for the averaging of the gray values, the gray value of the central pixel remains unchanged.

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

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.
• Automatically parallelized on channel level.
• Automatically parallelized on domain level.

Parameters

read_image(Image,'fabrik')
sigma_image(Image,ImageSigma,5,5,3)
disp_image(ImageSigma,WindowHandle)

read_image(&Image,"fabrik");
sigma_image(Image,&ImageSigma,5,5,3);
disp_image(ImageSigma,WindowHandle);

read_image(Image,'fabrik')
sigma_image(Image,ImageSigma,5,5,3)
disp_image(ImageSigma,WindowHandle)

read_image(Image,'fabrik')
sigma_image(Image,ImageSigma,5,5,3)
disp_image(ImageSigma,WindowHandle)

read_image(Image,'fabrik')
sigma_image(Image,ImageSigma,5,5,3)
disp_image(ImageSigma,WindowHandle)

Complexity

For each pixel: O(MaskHeight*MaskWidth).

Result

If the parameter values are correct the operator sigma_imagesigma_imagesigma_imageSigmaImageSigmaImage returns the value 2 (H_MSG_TRUE). The behavior in case of empty input (no input images available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

read_imageread_imageread_imageReadImageReadImage

Possible Successors

thresholdthresholdthresholdThresholdThreshold, dyn_thresholddyn_thresholddyn_thresholdDynThresholdDynThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing

Alternatives

anisotropic_diffusionanisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusion, rank_imagerank_imagerank_imageRankImageRankImage

See also

smooth_imagesmooth_imagesmooth_imageSmoothImageSmoothImage, binomial_filterbinomial_filterbinomial_filterBinomialFilterBinomialFilter, gauss_imagegauss_imagegauss_imageGaussImageGaussImage, mean_imagemean_imagemean_imageMeanImageMeanImage

References

R. Haralick, L. Shapiro; “Computer and Robot Vision”; Addison-Wesley, 1992, Seite 325

Module

Foundation