Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Image Local Transforms » SmoothImage_Gauss

SmoothImage_Gauss


Module: FoundationLite

Smooths an image using a gaussian kernel.

Name Type Range Description
inImage Image Input image
inRoi Region* Range of output pixels to be computed
inStdDevX Real 0.0 - Horizontal smoothing standard deviation
inStdDevY Real* 0.0 - Vertical smoothing standard deviation
inKernelRelativeSize Real 0.0 - 3.0 A multiple of the standard deviation determining the size of the kernel
outImage Image Output image
diagKernelRadiusX Integer Horizontal radius of Gaussian kernel being used
diagKernelRadiusY Integer Vertical radius of Gaussian kernel being used

Applications

Removal of gaussian noise from images.

Hints

  • To make smoothing stronger, increase the inStdDevX and - optionally - inStdDevY.
  • Increase inKernelRelativeSize to achieve better quality at the cost of a bit longer execution time.
  • For small kernels consider switching to SmoothImage_Gauss_Mask to achieve the highest performance.

Examples

Description of usage of this filter can be found in examples and tutorial: Blister Inspection (NET GmbH), Fertilizer Granulation, HMI Configuration Page, Image Modification Using the HMI, Using HMI multipanel control.

SmoothImage_Gauss performed on a sample image with inStdDevX = 3.0.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: UINT8, SINT16, REAL.

This operation is optimized for SSE41 technology for pixels of type: UINT16.

This operation is optimized for AVX2 technology for pixels of types: UINT8, SINT16, UINT16, REAL.

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in SmoothImage_Gauss.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of SmoothImage filter group.