bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter (Operator)

Name

bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter — Bilaterale Filterung eines Bildes.

Signatur

bilateral_filter(Image, ImageJoint : ImageBilateral : SigmaSpatial, SigmaRange, GenParamName, GenParamValue : )

Herror bilateral_filter(const Hobject Image, const Hobject ImageJoint, Hobject* ImageBilateral, double SigmaSpatial, double SigmaRange, const char* GenParamName, double GenParamValue)

Herror T_bilateral_filter(const Hobject Image, const Hobject ImageJoint, Hobject* ImageBilateral, const Htuple SigmaSpatial, const Htuple SigmaRange, const Htuple GenParamName, const Htuple GenParamValue)

void BilateralFilter(const HObject& Image, const HObject& ImageJoint, HObject* ImageBilateral, const HTuple& SigmaSpatial, const HTuple& SigmaRange, const HTuple& GenParamName, const HTuple& GenParamValue)

HImage HImage::BilateralFilter(const HImage& ImageJoint, double SigmaSpatial, double SigmaRange, const HTuple& GenParamName, const HTuple& GenParamValue) const

HImage HImage::BilateralFilter(const HImage& ImageJoint, double SigmaSpatial, double SigmaRange, const HString& GenParamName, double GenParamValue) const

HImage HImage::BilateralFilter(const HImage& ImageJoint, double SigmaSpatial, double SigmaRange, const char* GenParamName, double GenParamValue) const

HImage HImage::BilateralFilter(const HImage& ImageJoint, double SigmaSpatial, double SigmaRange, const wchar_t* GenParamName, double GenParamValue) const   ( Nur Windows)

static void HOperatorSet.BilateralFilter(HObject image, HObject imageJoint, out HObject imageBilateral, HTuple sigmaSpatial, HTuple sigmaRange, HTuple genParamName, HTuple genParamValue)

HImage HImage.BilateralFilter(HImage imageJoint, double sigmaSpatial, double sigmaRange, HTuple genParamName, HTuple genParamValue)

HImage HImage.BilateralFilter(HImage imageJoint, double sigmaSpatial, double sigmaRange, string genParamName, double genParamValue)

def bilateral_filter(image: HObject, image_joint: HObject, sigma_spatial: float, sigma_range: float, gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[int, float, str]]) -> HObject

Beschreibung

bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter führt eine gemeinsame bilaterale Filterung des Eingabebildes ImageImageImageimageimage und des Führungsbildes ImageJointImageJointImageJointimageJointimage_joint durch und liefert das Ergebnis in ImageBilateralImageBilateralImageBilateralimageBilateralimage_bilateral zurück. ImageImageImageimageimage und ImageJointImageJointImageJointimageJointimage_joint müssen dieselbe Größe haben und vom gleichen Typ sein.

SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial definiert die Größe der Filtermaske und korrespondiert mit der Standardabweichung eines gewöhnlichen Gaussfilters. Größere Werte erhöhen den Einflussbereich des Filters und führen dazu, dass weniger Details erhalten bleiben.

SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range wird verwendet, um die Filtermaske abhängig vom Inhalt von ImageJointImageJointImageJointimageJointimage_joint um das aktuelle Pixel zu verändern. Nur Pixel in Bereichen mit schwachen Kanten, die einen niedrigeren Kontrast als SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range haben, beeinflussen die Glättung. Es ist zu beachten, dass der Kontrast in uint2- oder real-Bildern deutlich vom Defaultwert von SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range abweichen kann und der Parameter daher gesondert eingestellt werden muss.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value können zurzeit verwendet werden, um den Trade-off zwischen Geschwindigkeit und Genauigkeit zu steuern (siehe unten).

Einfluss des Führungsbildes

Jedes Pixel von ImageImageImageimageimage wird mit einer Filtermaske, die von ImageJointImageJointImageJointimageJointimage_joint abhängt, gefiltert. Die Filtermaske kombiniert eine Gauss'sche Nähefunktion, die von SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial abhängt, und eine Gauss'sche Ähnlichkeitsfunktion, die Grauwertunterschiede abhängig von SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range gewichtet.

Beispiele von lokalen Filtermasken abhängig von ImageJointImageJointImageJointimageJointimage_joint: Links: In homogenen Bereichen entspricht die Filtermaske einer Gaußglocke. Mitte: Die Filtermaske passt sich der Linie an. Das heißt, nur dunkle Pixel werden geglättet, die Kanten bleiben erhalten. Rechts: Die Filtermaske ähnelt der Ecke. Man beachte, dass sie über den Schatten in Bereiche mit ähnlichen Grauwerten hineinragt.

Sind ImageImageImageimageimage und ImageJointImageJointImageJointimageJointimage_joint identisch, verhält sich bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter wie ein kantenerhaltender Glättungsfilter, dessen Maskengröße von SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial bestimmt wird. Pixel an Kanten mit einem Kontrast, der deutlich über SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range liegt, werden erhalten, während Pixel in homogenen Bereichen geglättet werden.

( 1) ( 2) ( 3)

Sind ImageImageImageimageimage und ImageJointImageJointImageJointimageJointimage_joint verschieden, wird jeder Pixel von ImageImageImageimageimage mit einer Filtermaske geglättet, die von ImageJointImageJointImageJointimageJointimage_joint beeinflusst wird. Pixel und Positionen, wo ImageJointImageJointImageJointimageJointimage_joint starke Kanten aufweist, deren Kontrast deutlich über SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range liegt, werden weniger geglättet als Pixel in homogenen Bereichen.

( 1) ( 2) ( 3)

Ist ImageJointImageJointImageJointimageJointimage_joint konstant, verhält sich bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter äquivalent zu einer Gauss-Glättung mit SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial (siehe gauss_filtergauss_filterGaussFilterGaussFiltergauss_filter oder smooth_imagesmooth_imageSmoothImageSmoothImagesmooth_image).

( 1) ( 2) ( 3)

Einfluss der Glättungsparameter

Die folgenden Beispiele zeigen den Einfluss von SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range auf einem künstlichen Bild. In diesem Bild liegt das Rauschlevel bei 10 Grauwerten, die linke Kante hat einen Kontrast von 50 Grauwerten, die rechte Kante hat einen Kontrast von 100 Grauwerten. Die gelbe Linie zeigt das Grauwertprofil eines horizontalen Querschnitts.

Originalbild mit überlagertem Grauwertprofil. Das Bild wird sowohl für ImageImageImageimageimage als auch für ImageJointImageJointImageJointimageJointimage_joint verwendet.
Filterergebnis mit SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range = 1: Kein Effekt, da SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range unter dem Rauschlevel liegt. Daher wird das Rauschen als Kante behandelt und erhalten.
Filterergebnis mit SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range = 25: Das Rauschen wird geglättet, die Kanten bleiben erhalten.
Filterergebnis mit SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range = 50: Die schwächere Kante wird geglättet, die stärkere Kante bleibt erhalten.
Filterergebnis mit SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range = 100: Beide Kanten werden geglättet.

Generische Parameter

Die folgenden Werte für GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name werden unterstützt:

'sampling_method'"sampling_method""sampling_method""sampling_method""sampling_method"

Per Default verwendet bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter einen Näherungsalgorithmus, der nur eine Teilmenge von abgetasteten Punkten für die Berechnung der lokalen Filtermasken verwendet.

Mit 'sampling_method'"sampling_method""sampling_method""sampling_method""sampling_method" kann die verwendete Abtastmethode ausgewählt werden. Mögliche Werte sind:

'grid'"grid""grid""grid""grid" (Default)

Verwendet ein reguläres Gitter zur Abtastung der Filtermasken.

'poisson_disk'"poisson_disk""poisson_disk""poisson_disk""poisson_disk"

Verwendet eine Poisson-Disk-Abtastung. Diese Methode ist langsamer als 'grid'"grid""grid""grid""grid", möglicherweise liefert sie aber weniger Artefakte.

'exact'"exact""exact""exact""exact"

Verwendet alle verfügbaren Punkte. Diese Methode ist die genaueste, aber auch die langsamste. Falls 'exact'"exact""exact""exact""exact" verwendet wird, wird 'sampling_ratio'"sampling_ratio""sampling_ratio""sampling_ratio""sampling_ratio" ignoriert.

'sampling_ratio'"sampling_ratio""sampling_ratio""sampling_ratio""sampling_ratio"

Steuert, wie viele Punkte für die Abtastung verwendet werden.

Durch Setzen von 'sampling_ratio'"sampling_ratio""sampling_ratio""sampling_ratio""sampling_ratio" auf 1.0 wird die exakte Methode verwendet. Eine niedrigere Abtastrate führt zu einer schnelleren Filterung, aber auch zu etwas ungenaueren Ergebnissen.

Empfohlene Werte: 0.25, 0.5, 0.75, 1.0

Default: 0.50

Rolling-Bilateral-Filter

bilateral_filterbilateral_filterBilateralFilterBilateralFilterbilateral_filter kann iterativ aufgerufen werden. In dem Fall wird das Ergebnis einer Iteration als Führungsbild der nächsten Iteration verwendet. Das kann nützlich sein, z.B. um kleine Strukturen aus dem Originalbild zu entfernen, auch wenn sie einen hohen Kontrast haben.

Das folgende Beispiel zeigt den Effekt des Rolling-Filters anhand eines künstlichen Beispielbildes. In diesem Bild liegt das Rauschlevel bei 10 Grauwerten, der Kontrast zwischen dunklen und hellen Bereichen beträgt 100 Grauwerte. Der linke helle Streifen ist 10 Pixel breit, der rechte Streifen 40 Pixel. Die gelbe Linie zeigt das Grauwertprofil eines horizontalen Querschnitts.

Verwendete Parameter: ImageJointImageJointImageJointimageJointimage_joint konstant, SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial = 25, SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range = 15.
* Verwenden des Rolling-Bilateral-Filter
* (verwende ein konstantes Führungsbild für die erste Iteration).
gen_image_proto(Image, ImageJoint, 128)gen_image_proto(Image, ImageJoint, 128)GenImageProto(Image, ImageJoint, 128)GenImageProto(Image, ImageJoint, 128)gen_image_proto(Image, ImageJoint, 128)
for I := 1 to 6 by 1
bilateral_filter(Image, ImageJoint, ImageJoint, 25, 15, [], [])bilateral_filter(Image, ImageJoint, ImageJoint, 25, 15, [], [])BilateralFilter(Image, ImageJoint, ImageJoint, 25, 15, [], [])BilateralFilter(Image, ImageJoint, ImageJoint, 25, 15, [], [])bilateral_filter(Image, ImageJoint, ImageJoint, 25, 15, [], [])
endfor
( 1) ( 2)
(1) Eingabebild ImageImageImageimageimage und (2) ImageJointImageJointImageJointimageJointimage_joint für die erste Iteration des Rolling-Filters.
Ergebnis nach der ersten Iteration: Der schmalere Streifen ist verschwunden.
Ergebnis nach der dritten Iteration: Die Kanten des rechten Streifens sind teilweise wiederhergestellt.
Ergebnis nach der sechsten Iteration: Die Kanten des rechten Streifens sind komplett wiederhergestellt.

Mathematischer Hintergrund

Die Berechnung der gefilterten Grauwerte beruht auf folgender Formel:

Dabei ist die Nähefunktion (closeness function)

und die Ähnlichkeitsfunktion (similarity function) ist ein Normalisierungsfaktor , und sind die Grauwerte von ImageBilateralImageBilateralImageBilateralimageBilateralimage_bilateral, ImageImageImageimageimage und ImageJointImageJointImageJointimageJointimage_joint an der Pixelposition . ist die Umgebung um den Pixel .

Das Konzept der Glättungsfilter ist in der Einleitung zum Kapitel Filter / Glättung beschrieben.

Ausführungsinformationen

Parameter

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject (byte / uint2 / real)

Zu filterndes Bild.

ImageJointImageJointImageJointimageJointimage_joint (input_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject (byte / uint2 / real)

Führungsbild.

ImageBilateralImageBilateralImageBilateralimageBilateralimage_bilateral (output_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject * (byte / uint2 / real)

Gefiltertes Ausgabebild.

SigmaSpatialSigmaSpatialSigmaSpatialsigmaSpatialsigma_spatial (input_control)  real HTuplefloatHTupleHtuple (real) (double) (double) (double)

Größe der Gaußglocke der Nähefunktion.

Default: 3.0

Wertevorschläge: 1.0, 2.0, 3.0, 10.0

Restriktion: SigmaSpatial > 0.6

SigmaRangeSigmaRangeSigmaRangesigmaRangesigma_range (input_control)  real HTuplefloatHTupleHtuple (real) (double) (double) (double)

Größe der Gaußglocke der Ähnlichkeitsfunktion.

Default: 20.0

Wertevorschläge: 3.0, 10.0, 20.0, 50.0, 100.0

Restriktion: SigmaRange > 0.0001

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Namen der generischen Parameter.

Default: []

Werteliste: 'sampling_method'"sampling_method""sampling_method""sampling_method""sampling_method", 'sampling_ratio'"sampling_ratio""sampling_ratio""sampling_ratio""sampling_ratio"

GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control)  attribute.value(-array) HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Werte der generischen Parameter.

Default: []

Wertevorschläge: 'grid'"grid""grid""grid""grid", 'poisson_disk'"poisson_disk""poisson_disk""poisson_disk""poisson_disk", 'exact'"exact""exact""exact""exact", 0.5, 0.25, 0.75, 1.0

Beispiel (HDevelop)

read_image (Image, 'mreut')
* Edge-preserving smoothing
bilateral_filter (Image, Image, ImageBilateral, 5, 20, [], [])
* Rolling filter (5 iterations)
gen_image_proto (Image, ImageJoint, 0)
for I := 1 to 5 by 1
  bilateral_filter (Image, ImageJoint, ImageJoint, 5, 20, [], [])
endfor

Vorgänger

read_imageread_imageReadImageReadImageread_image

Nachfolger

thresholdthresholdThresholdThresholdthreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholddyn_threshold, var_thresholdvar_thresholdVarThresholdVarThresholdvar_threshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing

Alternativen

guided_filterguided_filterGuidedFilterGuidedFilterguided_filter, anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionanisotropic_diffusion, median_imagemedian_imageMedianImageMedianImagemedian_image

Literatur

C. Tomasi, R. Manduchi: “Bilateral filtering for gray and color images“; Sixth International Conference in Computer Vision; S. 839-846; January 1998.
F. Banterle, M. Corsini, P. Cignoni, R. Scopigno: “A Low-Memory, Straightforward and Fast Bilateral Filter Through Subsampling in Spatial Domain“; Computer Graphics Forum, no. 1, vol 31; S. 19-23; February 2012.
G. Petschnigg, R. Szeliski, M. Agrawala, M. Cohen, H. Hoppe, K. Toyama: “Digital Photography with Flash and No-flash Image Pairs“; ACM Trans., no. 3, vol. 23; S. 9; August 2004.
R. Bridson: “Fast Poisson Disk Sampling in Arbitrary Dimensions“; ACM SIGGRAPH 2007 Sketches, no. 22; 2007.

Modul

Foundation