KlassenKlassenKlassenKlassen | | | | Operatoren

lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss (Operator)

Name

lines_gausslines_gaussLinesGausslines_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)

Herror lines_gauss(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)

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

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

void HOperatorSetX.LinesGauss(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*Lines, [in] VARIANT Sigma, [in] VARIANT Low, [in] VARIANT High, [in] VARIANT LightDark, [in] VARIANT ExtractWidth, [in] VARIANT LineModel, [in] VARIANT CompleteJunctions)

IHXLDContX* HImageX.LinesGauss(
[in] VARIANT Sigma, [in] VARIANT Low, [in] VARIANT High, [in] BSTR LightDark, [in] BSTR ExtractWidth, [in] BSTR LineModel, [in] BSTR CompleteJunctions)

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_gaussLinesGausslines_gaussLinesGaussLinesGauss können Linien (gekrümmt-lineare Strukturen) aus einem Bild ImageImageImageImageImageimage extrahiert werden. Die extrahierten Linien werden in LinesLinesLinesLinesLineslines als subpixel-genaue XLD-Konturen zurückgegeben. Der Parameter LightDarkLightDarkLightDarkLightDarkLightDarklightDark bestimmt, ob helle oder dunkle Linien extrahiert werden sollen. Wenn ExtractWidthExtractWidthExtractWidthExtractWidthExtractWidthextractWidth auf 'true'"true""true""true""true""true" gesetzt wird, so wird für jeden Linienpunkt die Linienbreite extrahiert. Wenn LineModelLineModelLineModelLineModelLineModellineModel auf einen Wert ungleich 'none'"none""none""none""none""none" gesetzt wird, kompensiert lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss 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 LineModelLineModelLineModelLineModelLineModellineModel zwischen balkenförmigen Linien (LineModelLineModelLineModelLineModelLineModellineModel = 'bar-shaped'"bar-shaped""bar-shaped""bar-shaped""bar-shaped""bar-shaped"), parabolischen Linien (LineModelLineModelLineModelLineModelLineModellineModel = 'parabolic'"parabolic""parabolic""parabolic""parabolic""parabolic") und Gaußschen Linien (LineModelLineModelLineModelLineModelLineModellineModel = 'gaussian'"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 LineModelLineModelLineModelLineModelLineModellineModel wird nur beachtet, falls ExtractWidthExtractWidthExtractWidthExtractWidthExtractWidthextractWidth='true'"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 CompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionscompleteJunctions='true'"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 SigmaSigmaSigmaSigmaSigmasigma bestimmt dabei die Stärke der Glättung. Große Werte für SigmaSigmaSigmaSigmaSigmasigma 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_facetLinesFacetlines_facetLinesFacetLinesFacet ist aber kein Schwingen der Linien für große Glättung zu beobachten. Ein weiterer Vorteil gegenüber lines_facetlines_facetLinesFacetlines_facetLinesFacetLinesFacet 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 HighHighHighHighHighhigh ist, sofort als sichere Linienpunkte akzeptiert. Punkte, deren zweite Ableitung kleiner als LowLowLowLowLowlow 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_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold). Allerdings wird diese Funktion nicht benutzt, da sonst keine subpixel-genaue Extraktion möglich wäre.

Bei der Wahl der Schwellenwerte HighHighHighHighHighhigh und LowLowLowLowLowlow ist zu beachten, dass die zweite Richtungsableitung von der Amplitude und Breite der Linie, sowie von der Größe des Glättungsparameters SigmaSigmaSigmaSigmaSigmasigma 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 SigmaSigmaSigmaSigmaSigmasigma: Je größer SigmaSigmaSigmaSigmaSigmasigma gewählt wird, desto kleiner wird die zweite Ableitung. Das bedeutet, dass für starke Glättung entsprechend kleinere Werte für HighHighHighHighHighhigh und LowLowLowLowLowlow 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 SigmaSigmaSigmaSigmaSigmasigma = 1.5 extrahiert werden sollen, so sollte HighHighHighHighHighhigh größer als 14 gewählt werden. Wenn dagegen 10 Pixel breite Linien mit einer Amplitude größer als 100 und einer Glättung SigmaSigmaSigmaSigmaSigmasigma = 3 gefunden werden sollen, so sollte HighHighHighHighHighhigh größer als 3.5 gesetzt werden. Als Werte für LowLowLowLowLowlow empfehlen sich Werte zwischen 0.25 HighHighHighHighHighhigh und 0.5 HighHighHighHighHighhigh.

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

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

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

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

Der Winkel der Richtung senkrecht zur Linie

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

Die Größe der zweiten Ableitung

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

'width_left'"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""width_right":

Die Linienbreite rechts von der Linie

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

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

Die Asymmetrie des Linienpunkts

'contrast'"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_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld ausgelesen werden.

lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss 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 SigmaSigmaSigmaSigmaSigmasigma zu klein gewählt, so werden die Attribute 'width_left'"width_left""width_left""width_left""width_left""width_left", 'width_right'"width_right""width_right""width_right""width_right""width_right", 'asymmetry'"asymmetry""asymmetry""asymmetry""asymmetry""asymmetry" und 'contrast'"contrast""contrast""contrast""contrast""contrast" auf Null gesetzt.

lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss wird durch SSE2 Instruktionen beschleunigt, falls der Systemparameter 'sse2_enable'"sse2_enable""sse2_enable""sse2_enable""sse2_enable""sse2_enable" auf 'true'"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""sse2_enable" auf 'false'"false""false""false""false""false" setzen, bevor Sie lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss aufrufen. Dadurch verwendet lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss keine SSE2 Beschleunigungen. Vergessen Sie nicht 'sse2_enable'"sse2_enable""sse2_enable""sse2_enable""sse2_enable""sse2_enable" danach wieder auf 'true'"true""true""true""true""true" zu setzen.

Wird lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss auf OpenCL-Geräten ausgeführt, gelten die selben Einschränkungen wie für derivate_gaussderivate_gaussDerivateGaussderivate_gaussDerivateGaussDerivateGauss: SigmaSigmaSigmaSigmaSigmasigma 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.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / int1 / int2 / uint2 / int4 / real)

Eingabebild.

LinesLinesLinesLinesLineslines (output_object)  xld_cont-array objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Extrahierte Linien.

SigmaSigmaSigmaSigmaSigmasigma (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 sigma ≤ 20

Empfohlene Schrittweite: 0.1

LowLowLowLowLowlow (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 low ≤ 20

Empfohlene Schrittweite: 0.5

Restriktion: Low >= 0

HighHighHighHighHighhigh (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 high ≤ 35

Empfohlene Schrittweite: 0.5

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

LightDarkLightDarkLightDarkLightDarkLightDarklightDark (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Helle oder dunkle Linien extrahieren.

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

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

ExtractWidthExtractWidthExtractWidthExtractWidthExtractWidthextractWidth (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Soll die Linienbreite extrahiert werden?

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

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

LineModelLineModelLineModelLineModelLineModellineModel (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

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

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

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

CompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionscompleteJunctions (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Sollen die Kreuzungspunkte vervollständigt werden?

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

Werteliste: 'false'"false""false""false""false""false", 'true'"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 (C++ (HALCON 5.0-10.0))

/* Detection of lines in an aerial image */
HWindow w(0,0,520,560);
HImage Image("mreut4_3");
HXLDContArray Lines = Image.LinesGauss(1.5,3,8,"light","true",
                                       "bar-shaped","true");
Lines.Display(w);

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 ImageImageImageImageImageimage. 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 ImageImageImageImageImageimage und der Breite W von ImageImageImageImageImageimage. Sei S = W*H, dann benötigt lines_gausslines_gaussLinesGausslines_gaussLinesGaussLinesGauss 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_gaussLinesGausslines_gaussLinesGaussLinesGauss 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

gen_polygons_xldgen_polygons_xldGenPolygonsXldgen_polygons_xldGenPolygonsXldGenPolygonsXld

Alternativen

lines_facetlines_facetLinesFacetlines_facetLinesFacetLinesFacet

Siehe auch

bandpass_imagebandpass_imageBandpassImagebandpass_imageBandpassImageBandpassImage, dyn_thresholddyn_thresholdDynThresholddyn_thresholdDynThresholdDynThreshold, topographic_sketchtopographic_sketchTopographicSketchtopographic_sketchTopographicSketchTopographicSketch

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


KlassenKlassenKlassenKlassen | | | | Operatoren