laplacelaplaceLaplacelaplaceLaplaceLaplace (Operator)

Name

laplacelaplaceLaplacelaplaceLaplaceLaplace — Näherung des Laplace-Operators durch finite Differenzen.

Signatur

Beschreibung

laplacelaplaceLaplacelaplaceLaplaceLaplace filtert die Eingabebilder (ImageImageImageImageImageimage) mittels des Laplace-Operators. Abhängig vom Parameter FilterMaskFilterMaskFilterMaskFilterMaskFilterMaskfilterMask werden folgende lokale Approximationen an den Laplace-Operator zugrundegelegt:

'n_4'

                           1
                  1       -4      1
                           1

'n_8'

                  1       1       1
                  1       -8      1
                  1       1       1

'n_8_isotropic'

                  10      22     10
                  22     -128    22
                  10      22     10

Für die einzelnen Filtermasken werden folgende Normierungen der Ergebnisgrauwerte, (d.h. Division durch die angegebene Zahl) durchgeführt: 'n_4' Normierung durch 1, 'n_8', Normierung durch 2 und 'n_8_isotropic' Normierung durch 32.

Für eine 3x3 Laplace-Filterung (MaskSizeMaskSizeMaskSizeMaskSizeMaskSizemaskSize = 3) wird der entsprechende Filter direkt angewandt. Für größere Laplace-Filter wird das Eingabebild dagegen zunächst mit dem Gaußfilter (siehe gauss_imagegauss_imageGaussImagegauss_imageGaussImageGaussImage) oder einem Binomialfilter (siehe binomial_filterbinomial_filterBinomialFilterbinomial_filterBinomialFilterBinomialFilter) der Größe MaskSizeMaskSizeMaskSizeMaskSizeMaskSizemaskSize-2 geglättet. Der Gaußfilter wird durch die oben angegebenen Werte von ResultTypeResultTypeResultTypeResultTypeResultTyperesultType ausgewählt. Hierbei ist MaskSizeMaskSizeMaskSizeMaskSizeMaskSizemaskSize = 5, 7, 9, 11 oder 13 zu wählen. Der Binomialfilter wird ausgewählt, indem '_binomial'"_binomial""_binomial""_binomial""_binomial""_binomial" an die oben angegebenen Werte von ResultTypeResultTypeResultTypeResultTypeResultTyperesultType angehängt wird. Hier kann MaskSizeMaskSizeMaskSizeMaskSizeMaskSizemaskSize zwischen 5 und 39 gewählt werden. Zusätzlich ist es hier möglich, unterschiedliche Glättungen in Spalten- und Zeilenrichtung durch Angabe von zwei Werten in MaskSizeMaskSizeMaskSizeMaskSizeMaskSizemaskSize zu erreichen. Dabei entspricht der erste Wert der Maskenbreite (Glättung in Spaltenrichtung) und der zweite Wert der Maskenhöhe (Glättung in Zeilenrichtung) des Binomialfilters. Somit ist z.B.

     laplace(O:R:'absolute',MaskSize,N:)

für MaskSize > 3 äquivalent zu

     gauss_image(O:G:MaskSize-2:) >
     laplace(G:R:'absolute',3,N:)

und

     laplace(O:R:'absolute_binomial',MaskSize,N:)

ist äquivalent zu

     binomial_filter(O:B:MaskSize-2,MaskSize-2:) >
     laplace(B:R:'absolute',3,N:).

laplacelaplaceLaplacelaplaceLaplaceLaplace liefert entweder den Absolutbetrag des Laplace-gefilterten Eingabebildes (ResultTypeResultTypeResultTypeResultTypeResultTyperesultType = 'absolute'"absolute""absolute""absolute""absolute""absolute") in einem byte/uint2-Bild oder unmittelbar das Filterergebnis (ResultTypeResultTypeResultTypeResultTypeResultTyperesultType = 'signed'"signed""signed""signed""signed""signed" oder 'signed_clipped'"signed_clipped""signed_clipped""signed_clipped""signed_clipped""signed_clipped") mit einem Pixeltyp mit Vorzeichen zurück. Dabei ist bei 'signed_clipped'"signed_clipped""signed_clipped""signed_clipped""signed_clipped""signed_clipped" der Ausgabebildtyp von derselben Anzahl von Bytes wie der Eingabebildtyp (also int1 oder int2), während bei 'signed'"signed""signed""signed""signed""signed" der Ausgabebildtyp die nächsthöhere Anzahl an Bytes besitzt (also int2 oder int4).

Achtung

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.
• Automatisch parallelisiert auf Kanalebene.
• Automatisch parallelisiert auf Domainebene.

Parameter

Beispiel (C)

read_image(&Image,"mreut");
laplace(Image,&Laplace,"signed",3,"n_8_isotropic");
zero_crossing(Laplace,&ZeroCrossings);

Ergebnis

Sind die Parameterwerte korrekt, dann liefert laplacelaplaceLaplacelaplaceLaplaceLaplace den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

zero_crossingzero_crossingZeroCrossingzero_crossingZeroCrossingZeroCrossing, dual_thresholddual_thresholdDualThresholddual_thresholdDualThresholdDualThreshold, thresholdthresholdThresholdthresholdThresholdThreshold

Alternativen

diff_of_gaussdiff_of_gaussDiffOfGaussdiff_of_gaussDiffOfGaussDiffOfGauss, laplace_of_gausslaplace_of_gaussLaplaceOfGausslaplace_of_gaussLaplaceOfGaussLaplaceOfGauss, derivate_gaussderivate_gaussDerivateGaussderivate_gaussDerivateGaussDerivateGauss

Siehe auch

highpass_imagehighpass_imageHighpassImagehighpass_imageHighpassImageHighpassImage, edges_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage

Modul

Foundation