Back to FabImage Studio website

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

SmoothImage_Mean


Module: FoundationLite

Smooths an image by averaging pixels within a rectangular kernel.

Applications

Usually used for computing features related to local image "windows". Can be also used for noise removal, but Gauss is superior here.
Name Type Range Description
Input value inImage Image Input image
Input value inRoi Region* Range of outImage pixels to be computed
Input value inSourceRoi Region* Range of inImage pixels to be read
Input value inBorderColor Pixel* Color of the imaginary pixels outside the image boundaries
Input value inKernel KernelShape Kernel shape
Input value inRadiusX Integer 0 - Nearly half of the kernel's width (2*R+1)
Input value inRadiusY Integer* 0 - Nearly half of the kernel's height (2*R+1), or same as inRadiusX
Output value outImage Image Output image

Description

Replaces each pixel with the average of all pixels contained in a rectangular kernel. The width of the kernel is 2 * inRadiusX + 1, the height is 2 * inRadiusY + 1. When inRadiusY is set to Auto, then its value is implicitly copied from inRadiusX.

Hints

  • Define the size of the kernel by setting inRadiusX and - optionally - inRadiusY.
  • Highest performance will be achieved with inKernel = Box. Other kernel shapes will result is longer execution time.
  • Define inSourceRoi is some pixels of the input images should be ignored (advanced).

Examples

SmoothImage_Mean performed on a sample image with inRadiusX = 4.

Hardware Acceleration

This operation is optimized for PARALLEL SSE2 technology for pixels of types: UINT8, SINT8, SINT16, SINT32, 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, SINT8, SINT16, SINT32, REAL, UINT16.

This operation is optimized for NEON technology for pixels of types: UINT8, UINT16.

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 inBorderColor is relevant only when inSourceRoi is set to Auto (NIL) in SmoothImage_Mean.
DomainError Not supported kernel on input in SmoothImage_Mean.
DomainError Region exceeds an input image in SmoothImage_Mean.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of SmoothImage filter group.