laplacelaplaceLaplaceLaplace (Operator)

Name

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

Signatur

laplace(Image : ImageLaplace : ResultType, MaskSize, FilterMask : )

Herror laplace(const Hobject Image, Hobject* ImageLaplace, const char* ResultType, const Hlong MaskSize, const char* FilterMask)

Herror T_laplace(const Hobject Image, Hobject* ImageLaplace, const Htuple ResultType, const Htuple MaskSize, const Htuple FilterMask)

void Laplace(const HObject& Image, HObject* ImageLaplace, const HTuple& ResultType, const HTuple& MaskSize, const HTuple& FilterMask)

HImage HImage::Laplace(const HString& ResultType, const HTuple& MaskSize, const HString& FilterMask) const

HImage HImage::Laplace(const HString& ResultType, Hlong MaskSize, const HString& FilterMask) const

HImage HImage::Laplace(const char* ResultType, Hlong MaskSize, const char* FilterMask) const

HImage HImage::Laplace(const wchar_t* ResultType, Hlong MaskSize, const wchar_t* FilterMask) const   (Nur Windows)

static void HOperatorSet.Laplace(HObject image, out HObject imageLaplace, HTuple resultType, HTuple maskSize, HTuple filterMask)

HImage HImage.Laplace(string resultType, HTuple maskSize, string filterMask)

HImage HImage.Laplace(string resultType, int maskSize, string filterMask)

Beschreibung

laplacelaplaceLaplaceLaplaceLaplace filtert die Eingabebilder (ImageImageImageImageimage) mittels des Laplace-Operators. Abhängig vom Parameter FilterMaskFilterMaskFilterMaskFilterMaskfilterMask 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 (MaskSizeMaskSizeMaskSizeMaskSizemaskSize = 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_imageGaussImageGaussImageGaussImage) oder einem Binomialfilter (siehe binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter) der Größe MaskSizeMaskSizeMaskSizeMaskSizemaskSize-2 geglättet. Der Gaußfilter wird durch die oben angegebenen Werte von ResultTypeResultTypeResultTypeResultTyperesultType ausgewählt. Hierbei ist MaskSizeMaskSizeMaskSizeMaskSizemaskSize = 5, 7, 9, 11 oder 13 zu wählen. Der Binomialfilter wird ausgewählt, indem '_binomial'"_binomial""_binomial""_binomial""_binomial" an die oben angegebenen Werte von ResultTypeResultTypeResultTypeResultTyperesultType angehängt wird. Hier kann MaskSizeMaskSizeMaskSizeMaskSizemaskSize 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 MaskSizeMaskSizeMaskSizeMaskSizemaskSize 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:).

laplacelaplaceLaplaceLaplaceLaplace liefert entweder den Absolutbetrag des Laplace-gefilterten Eingabebildes (ResultTypeResultTypeResultTypeResultTyperesultType = 'absolute'"absolute""absolute""absolute""absolute") in einem byte/uint2-Bild oder unmittelbar das Filterergebnis (ResultTypeResultTypeResultTypeResultTyperesultType = 'signed'"signed""signed""signed""signed" oder '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" der Ausgabebildtyp von derselben Anzahl von Bytes wie der Eingabebildtyp (also int1 oder int2), während bei '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.

Ausführungsinformationen

Parameter

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / uint2)

Eingabebild.

ImageLaplaceImageLaplaceImageLaplaceImageLaplaceimageLaplace (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / uint2 / int2 / int2 / int4)

Laplace-gefiltertes Ausgabebild.

ResultTypeResultTypeResultTypeResultTyperesultType (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Typ des Ergebnisbildes, wobei für byte und uint2 der Absolutbetrag zurückgegeben wird.

Defaultwert: 'absolute' "absolute" "absolute" "absolute" "absolute"

Werteliste: 'absolute'"absolute""absolute""absolute""absolute", 'absolute_binomial'"absolute_binomial""absolute_binomial""absolute_binomial""absolute_binomial", 'signed'"signed""signed""signed""signed", 'signed_binomial'"signed_binomial""signed_binomial""signed_binomial""signed_binomial", 'signed_clipped'"signed_clipped""signed_clipped""signed_clipped""signed_clipped", 'signed_clipped_binomial'"signed_clipped_binomial""signed_clipped_binomial""signed_clipped_binomial""signed_clipped_binomial"

MaskSizeMaskSizeMaskSizeMaskSizemaskSize (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Filtergröße.

Defaultwert: 3

Werteliste: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39

FilterMaskFilterMaskFilterMaskFilterMaskfilterMask (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Filtermasle für den Laplace-Operator

Defaultwert: 'n_4' "n_4" "n_4" "n_4" "n_4"

Werteliste: 'n_4'"n_4""n_4""n_4""n_4", 'n_8'"n_8""n_8""n_8""n_8", 'n_8_isotropic'"n_8_isotropic""n_8_isotropic""n_8_isotropic""n_8_isotropic"

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 laplacelaplaceLaplaceLaplaceLaplace 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

zero_crossingzero_crossingZeroCrossingZeroCrossingZeroCrossing, dual_thresholddual_thresholdDualThresholdDualThresholdDualThreshold, thresholdthresholdThresholdThresholdThreshold

Alternativen

diff_of_gaussdiff_of_gaussDiffOfGaussDiffOfGaussDiffOfGauss, laplace_of_gausslaplace_of_gaussLaplaceOfGaussLaplaceOfGaussLaplaceOfGauss, derivate_gaussderivate_gaussDerivateGaussDerivateGaussDerivateGauss

Siehe auch

highpass_imagehighpass_imageHighpassImageHighpassImageHighpassImage, edges_imageedges_imageEdgesImageEdgesImageEdgesImage

Modul

Foundation