filters image using the guide image guide over range-r neighborhoods with pixel-value regularizer ϵ.


filters image so as to reduce noise, using image as the guide.

Details and Options

  • GuidedFilter is a nonlinear local filter used for edge-preserving smoothing and structure transfer.
  • GuidedFilter works with arbitrary 2D and 3D images, as well as numeric data arrays of any rank.
  • GuidedFilter[image,r,ϵ] is equivalent to GuidedFilter[image,image,r,ϵ].
  • The images image and guide need to have the same dimensions, but may have a different number of channels.
  • The radius r controls the scale over which the filter operates. Features smaller than r will typically be averaged out, and features larger than r will remain.
  • Larger values of ϵ result in more smoothing and less guidance, while smaller values of ϵ result in less smoothing and more guidance.
  • At the edges of the image, smaller neighborhoods are used.
  • If image is a multichannel image, the guidance is always applied to each channel separately.
  • If guide is a multichannel image, operations involving guide are performed using vector processing.
  • GuidedFilter can take an option MaxIterations to specify the maximum number of iterations. By default, one iteration is performed.


open all close all

Basic Examples  (2)

Filtering of an image:

Click for copyable input

Filtering of an image using a guide image:

Click for copyable input

Scope  (3)

Options  (1)

Applications  (8)

Properties & Relations  (3)

Introduced in 2015