Visitar URL original
ImageFilter—Wolfram Documentation

WOLFRAM

Wolfram Language & System Documentation Center

ImageFilter[f,image,r]

applies the function f to the range-r neighborhood of each pixel in each channel of image.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
Interleaving  
Masking  
Padding  
Applications  
Properties & Relations  
See Also
Tech Notes
Related Guides
History
Cite this Page

ImageFilter

ImageFilter[f,image,r]

applies the function f to the range-r neighborhood of each pixel in each channel of image.

Details and Options

  • ImageFilter is a generic neighborhood operator that replaces the value of each pixel by the result of applying a function to a pixel neighborhood. It can be used to implement linear or nonlinear local filters.
  • ImageFilter works with 2D and 3D images with any number of channels, operating separately on each channel.
  • ImageFilter[f,image,{r1,r2,…}] applies f to blocks centered on each pixel.
  • ImageFilter assumes the index coordinate system for lists and images.
  • The channel values supplied to f are normally in the range 0 to 1, regardless of the underlying type used in the Image object. The function f is assumed to return channel values that are normally in the range 0 to 1.
  • ImageFilter[f,image, r] returns an image of the same type as image.
  • The following options can be given:
  • Interleaving Falsewhether to supply f lists of channel values
    Masking Allregion of interest
    Padding "Fixed"what values to assume beyond the image
  • With the default setting Interleaving->False, the elements in the arrays to which f is applied are individual channel values for the pixels.
  • With Interleaving->True, the elements are instead the list of all channel values for a particular pixel.
  • ImageFilter by default gives an image of the same dimensions as image.
  • With a setting Padding->None, ImageFilter[f,image,…] normally gives an image smaller than image.

Examples

open all close all

Basic Examples  (1)

Blur an image by replacing each pixel with the local mean:

Wolfram Language code: ImageFilter[Mean[Flatten[#]]&, [image], 3]

Scope  (4)

Apply a local minimum filter to a binary image:

Wolfram Language code: ImageFilter[Min, [image], 2]

Apply a median filter to a grayscale image:

Wolfram Language code: ImageFilter[Median[Flatten[#]]&, [image], 5]

Apply a median filter to a color image:

Wolfram Language code: ImageFilter[Median[Flatten[#]]&, [image], 5]

Apply a local maximum filter to a 3D image:

Wolfram Language code: ImageFilter[Max, [image], 2]

Options  (5)

Interleaving  (1)

When filtering a color image, the filter is applied to each channel separately:

Wolfram Language code: ImageFilter[Mean[Flatten[#]]&, [image], 1]

Filter over all channels:

Wolfram Language code: ImageFilter[Mean[Flatten[#]]&, [image], 1, Interleaving -> True]

Masking  (1)

Process the area outside a disk:

Wolfram Language code: ImageFilter[Max, [image], 10, Masking -> Graphics[Disk[]]]

Padding  (3)

By default, a "Fixed" padding is used:

Wolfram Language code: ImageFilter[Min, [image], 2]

Pad with zero:

Wolfram Language code: ImageFilter[Min, [image], 2, Padding -> 0]

No padding results in a smaller image:

Wolfram Language code: ImageFilter[Min, [image], 15, Padding -> None]

Applications  (3)

Find the exact position of an image fragment:

Wolfram Language code: ImageFilter[Boole[# == ImageData[[image]]]&, [image], 9]

Create a mean filter using a line kernel:

Wolfram Language code: ker = IdentityMatrix[21] / 21; res1 = ImageFilter[Total[ker#, 2]&, [image], 10]

Median deviation filter:

Wolfram Language code: ImageFilter[MedianDeviation[Flatten[#]]&, [image], 2]// ImageAdjust

Properties & Relations  (2)

Morphological dilation using ImageFilter:

Wolfram Language code: ImageFilter[Max, [image], 1] == Dilation[[image], 1]

Use ImageFilter to perform a convolution:

Wolfram Language code: ker = BoxMatrix[1] / 9; ImageFilter[Total[ker#, 2]&, [image], 1]

For images of real types, this is equivalent to ImageConvolve:

Wolfram Language code: r = Image[[image], "Real"]; ImageDistance[ImageFilter[Total[ker#, 2]&, r, 1], ImageConvolve[r, ker]]
Wolfram Research (2008), ImageFilter, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFilter.html (updated 2012).

Text

Wolfram Research (2008), ImageFilter, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageFilter.html (updated 2012).

CMS

Wolfram Language. 2008. "ImageFilter." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2012. https://reference.wolfram.com/language/ref/ImageFilter.html.

APA

Wolfram Language. (2008). ImageFilter. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ImageFilter.html

BibTeX

@misc{reference.wolfram_2026_imagefilter, author="Wolfram Research", title="{ImageFilter}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/ImageFilter.html}", note=[Accessed: 14-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_imagefilter, organization={Wolfram Research}, title={ImageFilter}, year={2012}, url={https://reference.wolfram.com/language/ref/ImageFilter.html}, note=[Accessed: 14-November-2026]}