lines_gausslines_gaussLinesGaussLinesGausslines_gauss (Operator)

Name

lines_gausslines_gaussLinesGaussLinesGausslines_gauss — 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)

def lines_gauss(image: HObject, sigma: Union[float, int], low: Union[float, int], high: Union[float, int], light_dark: str, extract_width: str, line_model: str, complete_junctions: str) -> HObject

Beschreibung

Mit lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss 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 LightDarkLightDarkLightDarkLightDarklightDarklight_dark bestimmt, ob helle oder dunkle Linien extrahiert werden sollen. Wenn ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width auf 'true'"true""true""true""true""true" gesetzt wird, so wird für jeden Linienpunkt die Linienbreite extrahiert. Wenn LineModelLineModelLineModelLineModellineModelline_model auf einen Wert ungleich 'none'"none""none""none""none""none" gesetzt wird, kompensiert lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss 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 LineModelLineModelLineModelLineModellineModelline_model zwischen balkenförmigen Linien (LineModelLineModelLineModelLineModellineModelline_model = 'bar-shaped'"bar-shaped""bar-shaped""bar-shaped""bar-shaped""bar-shaped"), parabolischen Linien (LineModelLineModelLineModelLineModellineModelline_model = 'parabolic'"parabolic""parabolic""parabolic""parabolic""parabolic") und Gaußschen Linien (LineModelLineModelLineModelLineModellineModelline_model = '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 LineModelLineModelLineModelLineModellineModelline_model wird nur beachtet, falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width='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 CompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionscompleteJunctionscomplete_junctions='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_facetLinesFacetLinesFacetLinesFacetlines_facet ist aber kein Schwingen der Linien für große Glättung zu beobachten. Ein weiterer Vorteil gegenüber lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet 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_thresholdHysteresisThresholdHysteresisThresholdHysteresisThresholdhysteresis_threshold). 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_gaussLinesGaussLinesGaussLinesGausslines_gauss definiert folgende Attribute für jeden Linienpunkt, falls ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width 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 ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width 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 ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width auf 'true'"true""true""true""true""true" und LineModelLineModelLineModelLineModellineModelline_model 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. Der zurückgegebene Kontrast kann größere Werte annehmen als der maximal darstellbare Grauwert des Eingabebildes, insbesondere dann, wenn das durch LineModelLineModelLineModelLineModellineModelline_model festgelegte Linienmodell nicht im Bild vorliegt. So kann der Kontrast beispielsweise bei byte-Bildern größer als 255 sein.

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

lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss 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 muss 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_gaussLinesGaussLinesGaussLinesGausslines_gauss 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_gaussLinesGaussLinesGaussLinesGausslines_gauss aufrufen. Dadurch verwendet lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss 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_gaussLinesGaussLinesGaussLinesGausslines_gauss auf OpenCL-Geräten ausgeführt, gelten die selben Einschränkungen wie für derivate_gaussderivate_gaussDerivateGaussDerivateGaussDerivateGaussderivate_gauss: SigmaSigmaSigmaSigmasigmasigma muss so gewählt werden, dass die resultierende Filtermaske 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

ImageImageImageImageimageimage (input_object)  singlechannelimage objectHImageHObjectHImageHobject (byte / int1 / int2 / uint2 / int4 / real)

Eingabebild.

LinesLinesLinesLineslineslines (output_object)  xld_cont-array objectHXLDContHObjectHXLDContHobject *

Extrahierte Linien.

SigmaSigmaSigmaSigmasigmasigma (input_control)  number HTupleUnion[float, int]HTupleHtuple (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 ≤ Sigma Sigma Sigma Sigma sigma sigma

Empfohlene Schrittweite: 0.1

LowLowLowLowlowlow (input_control)  number HTupleUnion[float, int]HTupleHtuple (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 low

Empfohlene Schrittweite: 0.5

HighHighHighHighhighhigh (input_control)  number HTupleUnion[float, int]HTupleHtuple (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 high

Empfohlene Schrittweite: 0.5

Restriktion: High >= Low

LightDarkLightDarkLightDarkLightDarklightDarklight_dark (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (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"

ExtractWidthExtractWidthExtractWidthExtractWidthextractWidthextract_width (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (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"

LineModelLineModelLineModelLineModellineModelline_model (input_control)  string HTuplestrHTupleHtuple (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" "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"

CompleteJunctionsCompleteJunctionsCompleteJunctionsCompleteJunctionscompleteJunctionscomplete_junctions (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (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 (C++)

/* 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*SigmaSigmaSigmaSigmasigmasigma).

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

Nachfolger

gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXldgen_polygons_xld

Alternativen

lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet

Siehe auch

bandpass_imagebandpass_imageBandpassImageBandpassImageBandpassImagebandpass_image, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThresholddyn_threshold, topographic_sketchtopographic_sketchTopographicSketchTopographicSketchTopographicSketchtopographic_sketch

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.
C. Steger: „Unbiased extraction of lines with parabolic and Gaussian profiles“. Computer Vision and Image Understanding, vol. 117, no. 2, pp. 97-112, 2013.

Modul

2D Metrology