lines_gausslines_gaussLinesGaussLinesGauss (Operator)

Name

lines_gausslines_gaussLinesGaussLinesGauss — Erkennen von Linien und deren Breite.

Signatur

lines_gauss(Image : Lines : Sigma, Low, High, LightDark, ExtractWidth, LineModel, CompleteJunctions : )

Herror lines_gauss(const Hobject Image, Hobject* Lines, double Sigma, double Low, double High, const char* LightDark, const char* ExtractWidth, const char* LineModel, const char* CompleteJunctions)

Herror T_lines_gauss(const Hobject Image, Hobject* Lines, const Htuple Sigma, const Htuple Low, const Htuple High, const Htuple LightDark, const Htuple ExtractWidth, const Htuple LineModel, const Htuple CompleteJunctions)

void LinesGauss(const HObject& Image, HObject* Lines, const HTuple& Sigma, const HTuple& Low, const HTuple& High, const HTuple& LightDark, const HTuple& ExtractWidth, const HTuple& LineModel, const HTuple& CompleteJunctions)

HXLDCont HImage::LinesGauss(const HTuple& Sigma, const HTuple& Low, const HTuple& High, const HString& LightDark, const HString& ExtractWidth, const HString& LineModel, const HString& CompleteJunctions) const

HXLDCont HImage::LinesGauss(double Sigma, double Low, double High, const HString& LightDark, const HString& ExtractWidth, const HString& LineModel, const HString& CompleteJunctions) const

HXLDCont HImage::LinesGauss(double Sigma, double Low, double High, const char* LightDark, const char* ExtractWidth, const char* LineModel, const char* CompleteJunctions) const

HXLDCont HImage::LinesGauss(double Sigma, double Low, double High, const wchar_t* LightDark, const wchar_t* ExtractWidth, const wchar_t* LineModel, const wchar_t* CompleteJunctions) const   (Nur Windows)

static void HOperatorSet.LinesGauss(HObject image, out HObject lines, HTuple sigma, HTuple low, HTuple high, HTuple lightDark, HTuple extractWidth, HTuple lineModel, HTuple completeJunctions)

HXLDCont HImage.LinesGauss(HTuple sigma, HTuple low, HTuple high, string lightDark, string extractWidth, string lineModel, string completeJunctions)

HXLDCont HImage.LinesGauss(double sigma, double low, double high, string lightDark, string extractWidth, string lineModel, string completeJunctions)

Beschreibung

Mit lines_gausslines_gaussLinesGaussLinesGaussLinesGauss können Linien (gekrümmt-lineare Strukturen) aus einem Bild ImageImageImageImageimage extrahiert werden. Die extrahierten Linien werden in LinesLinesLinesLineslines als subpixel-genaue XLD-Konturen zurückgegeben. Der Parameter LightDarkLightDarkLightDarkLightDarklightDark bestimmt, ob helle oder dunkle Linien extrahiert werden sollen. Wenn ExtractWidthExtractWidthExtractWidthExtractWidthextractWidth auf 'true'"true""true""true""true" gesetzt wird, so wird für jeden Linienpunkt die Linienbreite extrahiert. Wenn LineModelLineModelLineModelLineModellineModel auf einen Wert ungleich 'none'"none""none""none""none" gesetzt wird, kompensiert lines_gausslines_gaussLinesGaussLinesGaussLinesGauss die Effekte von asymmetrischen Linien (Linien mit unterschiedlichem Kontrast auf beiden Seiten der Linie), und korrigiert die Position und Breite der Linie. Für das zur Korrektur verwendete Linienmodell kann zwischen mit LineModelLineModelLineModelLineModellineModel zwischen balkenförmigen Linien (LineModelLineModelLineModelLineModellineModel = 'bar-shaped'"bar-shaped""bar-shaped""bar-shaped""bar-shaped"), parabolischen Linien (LineModelLineModelLineModelLineModellineModel = 'parabolic'"parabolic""parabolic""parabolic""parabolic") und Gaußschen Linien (LineModelLineModelLineModelLineModellineModel = 'gaussian'"gaussian""gaussian""gaussian""gaussian") ausgewählt werden. Balkenförmige Linien sind für die meisten Anwendungen die richtige Wahl. Für die Extraktion von röhrenförmigen Objekten im Durchlicht (z.B. Blutgefäße in Röntgenaufnahmen) bieten sich die anderen zwei Modi an. Dabei sollte das parabolische Linienmodell für Bilder verwendet werden, in denen die Linien sehr scharf abgebildet sind, und das Gaußsche Linienmodell für Bilder, in denen die Linien weniger scharf abgebildet sind. Der Parameter LineModelLineModelLineModelLineModellineModel wird nur beachtet, falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidth='true'"true""true""true""true". Da der Linienextraktor aus differentialgeometrischen Gründen bestimmte Kreuzungspunkte nicht extrahieren kann, wird versucht, diese mit anderen Mitteln zu extrahieren, falls CompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionscompleteJunctions='true'"true""true""true""true" gesetzt wird.

Zur Extraktion werden in jedem Punkt des Bildes unter Verwendung der partiellen Ableitungen einer Gaußschen Glättungsmaske die Parameter eines quadratischen Polynoms in x und y berechnet. Der Parameter SigmaSigmaSigmaSigmasigma bestimmt dabei die Stärke der Glättung. Große Werte für SigmaSigmaSigmaSigmasigma sorgen für eine stärkere Glättung der Eingabedaten, können aber zu ungenauerer Lokalisation der Linien führen. Im Gegensatz zu lines_facetlines_facetLinesFacetLinesFacetLinesFacet ist aber kein Schwingen der Linien für große Glättung zu beobachten. Ein weiterer Vorteil gegenüber lines_facetlines_facetLinesFacetLinesFacetLinesFacet ist die genauere Lokalisation der Linien. Mit Hilfe der Parameter des Polynoms wird in jedem Bildpunkt die Linienrichtung bestimmt. Bildpunkte, die ein lokales Maximum in der zweiten Richtungsableitung senkrecht zur Linienrichtung besitzen, werden als Linienpunkte markiert. Die gefundenen Linienpunkte werden hierauf zu Konturen zusammengefasst. Dabei werden Punkte, die eine zweite Richtungsableitung, die größer als HighHighHighHighhigh ist, sofort als sichere Linienpunkte akzeptiert. Punkte, deren zweite Ableitung kleiner als LowLowLowLowlow ist, werden sofort verworfen. Alle Punkte, die eine zweite Ableitung zwischen diesen zwei Werten besitzen, werden akzeptiert, wenn sie durch einen Pfad mit sicheren Punkten verbunden sind. Dies ist ähnlich zu einer Hysterese-Schwellenwert-Operation mit unbegrenzter Pfadlänge (siehe hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThresholdHysteresisThreshold). Allerdings wird diese Funktion nicht benutzt, da sonst keine subpixel-genaue Extraktion möglich wäre.

Bei der Wahl der Schwellenwerte HighHighHighHighhigh und LowLowLowLowlow ist zu beachten, dass die zweite Richtungsableitung von der Amplitude und Breite der Linie, sowie von der Größe des Glättungsparameters SigmaSigmaSigmaSigmasigma abhängt. Dabei ist die Abhängigkeit von der Amplitude der Linie linear, d.h. je größer die Amplitude, desto größer die zweite Ableitung. Für die Breite der Linie besteht ein näherungsweise exponentieller Zusammenhang: Je breiter die Linie ist, desto kleiner ist die zweite Ableitung. Analoges gilt für die Abhängigkeit von SigmaSigmaSigmaSigmasigma: Je größer SigmaSigmaSigmaSigmasigma gewählt wird, desto kleiner wird die zweite Ableitung. Das bedeutet, dass für starke Glättung entsprechend kleinere Werte für HighHighHighHighhigh und LowLowLowLowlow gewählt werden müssen. Zwei Beispiele sollen dies verdeutlichen: Wenn im Bild 5 Pixel breite Linien mit einer Amplitude größer als 100 und einer Glättung SigmaSigmaSigmaSigmasigma = 1.5 extrahiert werden sollen, so sollte HighHighHighHighhigh größer als 14 gewählt werden. Wenn dagegen 10 Pixel breite Linien mit einer Amplitude größer als 100 und einer Glättung SigmaSigmaSigmaSigmasigma = 3 gefunden werden sollen, so sollte HighHighHighHighhigh größer als 3.5 gesetzt werden. Als Werte für LowLowLowLowlow empfehlen sich Werte zwischen 0.25 HighHighHighHighhigh und 0.5 HighHighHighHighhigh.

Die Parameter LowLowLowLowlow und HighHighHighHighhigh können aus den entsprechende Grauwertkontrastwerten der zu extrahierenden Linien (ContrastLow und ContrastHigh) und dem gewählten Wert für SigmaSigmaSigmaSigmasigma wie folgt berechnet werden:

Die extrahierten Linien werden in einer topologisch sauberen Struktur in LinesLinesLinesLineslines zurückgeliefert. Das bedeutet, dass die Linien an Kreuzungspunkten sauber aufgetrennt werden.

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss definiert folgende Attribute für jeden Linienpunkt, falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidth auf 'false'"false""false""false""false" gesetzt wurde:

'angle'"angle""angle""angle""angle":

Der Winkel der Richtung senkrecht zur Linie

'response'"response""response""response""response":

Die Größe der zweiten Ableitung

Falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidth auf 'true'"true""true""true""true" gesetzt wurde, werden zusätzlich zu 'angle'"angle""angle""angle""angle" und 'response'"response""response""response""response" noch folgende Attribute definiert:

'width_left'"width_left""width_left""width_left""width_left":

Die Linienbreite links von der Linie

'width_right'"width_right""width_right""width_right""width_right":

Die Linienbreite rechts von der Linie

Falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidth auf 'true'"true""true""true""true" und LineModelLineModelLineModelLineModellineModel auf einen Wert ungleich 'none'"none""none""none""none" gesetzt wurde, werden zusätzlich zu 'angle'"angle""angle""angle""angle", 'response'"response""response""response""response", 'width_left'"width_left""width_left""width_left""width_left" und 'width_right'"width_right""width_right""width_right""width_right" noch folgende Attribute definiert:

'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry":

Die Asymmetrie des Linienpunkts

'contrast'"contrast""contrast""contrast""contrast":

Der Kontrast des Linienpunkts

Dabei ist der Wert der Asymmetrie so gewählt, dass er positive Werte annimmt, wenn die Asymmetrie, d.h. der kleinere Gradient, auf der rechten Seite der Linie liegt, und dass er negative Werte annimmt, wenn die Asymmetrie auf der linken Seite der Linie liegt.

Der Kontrast ergibt sich aus der Differenz zwischen dem Grauwert der Linie und dem Grauwert des Hintergrundes. Der Wert für den Kontrast ist positiv, wenn helle Linien extrahiert werden und negativ, wenn dunkle Linien extrahiert werden.

Alle Attribute können mit get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld ausgelesen werden. Weitere Informationen zu Konturattributen können der Referenz von get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld entnommen werden.

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss kann auf OpenCL-Geräten ausgeführt werden.

Achtung

Im allgemeinen, aber besonders, wenn die Linienbreite extrahiert werden soll, sollte gewählt werden, wobei w die Breite (der halbe Durchmesser) der zu extrahierenden Linien im Bild ist. Als unterste Grenze muß gewählt werden. Falls z.B. Linien mit einer Breite von 4 Pixel (Durchmesser 8 Pixel) extrahiert werden sollen, sollte gewählt werden. Wird SigmaSigmaSigmaSigmasigma zu klein gewählt, so werden die Attribute 'width_left'"width_left""width_left""width_left""width_left", 'width_right'"width_right""width_right""width_right""width_right", 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry" und 'contrast'"contrast""contrast""contrast""contrast" auf Null gesetzt.

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss wird durch SSE2 Instruktionen beschleunigt, falls der Systemparameter 'sse2_enable'"sse2_enable""sse2_enable""sse2_enable""sse2_enable" auf 'true'"true""true""true""true" gesetzt ist (dies ist Standard, sofern SSE2 auf Ihrem Rechner verfügbar ist). Diese Implementierung ist aufgrund numerischer Probleme im Vergleich zur reinen C Version etwas ungenauer. Falls für Ihre Anwendung Genauigkeit wichtiger ist als Geschwindigkeit können Sie 'sse2_enable'"sse2_enable""sse2_enable""sse2_enable""sse2_enable" auf 'false'"false""false""false""false" setzen, bevor Sie lines_gausslines_gaussLinesGaussLinesGaussLinesGauss aufrufen. Dadurch verwendet lines_gausslines_gaussLinesGaussLinesGaussLinesGauss keine SSE2 Beschleunigungen. Vergessen Sie nicht 'sse2_enable'"sse2_enable""sse2_enable""sse2_enable""sse2_enable" danach wieder auf 'true'"true""true""true""true" zu setzen.

Wird lines_gausslines_gaussLinesGaussLinesGaussLinesGauss auf OpenCL-Geräten ausgeführt, gelten die selben Einschränkungen wie für derivate_gaussderivate_gaussDerivateGaussDerivateGaussDerivateGauss: SigmaSigmaSigmaSigmasigma muss so gewählt werden, dass die resultierende Filtermask kleiner als 129 Pixel groß ist. Es ist weiterhin zu beachten, dass das Ergebnis von dem der CPU- Implementierung abweichen kann.

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

Dieser Operator unterstützt Cancel-Timeouts und Interrupts.

Parameter

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / int1 / int2 / uint2 / int4 / real)

Eingabebild.

LinesLinesLinesLineslines (output_object)  xld_cont-array objectHXLDContHXLDContHobject *

Extrahierte Linien.

SigmaSigmaSigmaSigmasigma (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Stärke der Gaußschen Glättung.

Defaultwert: 1.5

Wertevorschläge: 1, 1.2, 1.5, 1.8, 2, 2.5, 3, 4, 5

Typischer Wertebereich: 0.7 ≤ Sigma Sigma Sigma Sigma sigma ≤ 20

Empfohlene Schrittweite: 0.1

LowLowLowLowlow (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Untere Schwelle für Hysterese-Schwellenwertoperation.

Defaultwert: 3

Wertevorschläge: 0, 0.5, 1, 2, 3, 4, 5, 8, 10

Typischer Wertebereich: 0 ≤ Low Low Low Low low ≤ 20

Empfohlene Schrittweite: 0.5

Restriktion: Low >= 0

HighHighHighHighhigh (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Obere Schwelle für Hysterese-Schwellenwertoperation.

Defaultwert: 8

Wertevorschläge: 0, 0.5, 1, 2, 3, 4, 5, 8, 10, 12, 15, 18, 20, 25

Typischer Wertebereich: 0 ≤ High High High High high ≤ 35

Empfohlene Schrittweite: 0.5

Restriktion: High >= 0 && High >= Low

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

Helle oder dunkle Linien extrahieren.

Defaultwert: 'light' "light" "light" "light" "light"

Werteliste: 'dark'"dark""dark""dark""dark", 'light'"light""light""light""light"

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

Soll die Linienbreite extrahiert werden?

Defaultwert: 'true' "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

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

Linienmodell, das zur Korrektur der Linienposition und -breite verwendet wird.

Defaultwert: 'bar-shaped' "bar-shaped" "bar-shaped" "bar-shaped" "bar-shaped"

Werteliste: 'bar-shaped'"bar-shaped""bar-shaped""bar-shaped""bar-shaped", 'gaussian'"gaussian""gaussian""gaussian""gaussian", 'none'"none""none""none""none", 'parabolic'"parabolic""parabolic""parabolic""parabolic"

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

Sollen die Kreuzungspunkte vervollständigt werden?

Defaultwert: 'true' "true" "true" "true" "true"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

Beispiel (HDevelop)

* Detection of lines in an aerial image
read_image(Image,'mreut4_3')
lines_gauss(Image,Lines,1.5,3,8,'light','true','bar-shaped','true')
dev_display(Lines)

Beispiel (C)

/* Detection of lines in an aerial image */
read_image(&Image,"mreut4_3");
lines_gauss(Image:&Lines:1.5,3,8,"light","true","bar-shaped","true");
disp_xld(Lines,WindowHandle);

Beispiel (HDevelop)

* Detection of lines in an aerial image
read_image(Image,'mreut4_3')
lines_gauss(Image,Lines,1.5,3,8,'light','true','bar-shaped','true')
dev_display(Lines)

Beispiel (HDevelop)

* Detection of lines in an aerial image
read_image(Image,'mreut4_3')
lines_gauss(Image,Lines,1.5,3,8,'light','true','bar-shaped','true')
dev_display(Lines)

Beispiel (HDevelop)

* Detection of lines in an aerial image
read_image(Image,'mreut4_3')
lines_gauss(Image,Lines,1.5,3,8,'light','true','bar-shaped','true')
dev_display(Lines)

Komplexität

Sei A die Anzahl von Pixeln in der Region von ImageImageImageImageimage. Dann ist die Laufzeitkomplexität O(A*Sigma).

Der Bedarf an temporären Speicher ist abhängig von der Höhe H der Region von ImageImageImageImageimage und der Breite W von ImageImageImageImageimage. Sei S = W*H, dann benötigt lines_gausslines_gaussLinesGaussLinesGaussLinesGauss mindestens 55*S Bytes an temporärem Speicher bei der Ausführung.

Ergebnis

Sind die Parameterwerte korrekt und tritt kein Fehler während der Berechnung auf, liefert lines_gausslines_gaussLinesGaussLinesGaussLinesGauss 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

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld

Alternativen

lines_facetlines_facetLinesFacetLinesFacetLinesFacet

Siehe auch

bandpass_imagebandpass_imageBandpassImageBandpassImageBandpassImage, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThreshold, topographic_sketchtopographic_sketchTopographicSketchTopographicSketchTopographicSketch

Literatur

C. Steger: „Extracting Curvilinear Structures: A Differential Geometric Approach“. In B. Buxton, R. Cipolla, eds., „Fourth European Conference on Computer Vision“, Lecture Notes in Computer Science, Volume 1064, Springer Verlag, pp. 630-641, 1996.
C. Steger: „Extraction of Curved Lines from Images“. In „13th International Conference on Pattern Recognition“, Volume II, pp. 251-255, 1996.
C. Steger: „An Unbiased Detector of Curvilinear Structures“. IEEE Transactions on Pattern Analysis and Machine Intelligence, vol. 20, no. 2, pp. 113-125, 1998.

Modul

2D Metrology