detect_edge_segmentsT_detect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegments (Operator)

Name

detect_edge_segmentsT_detect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegments — Detektion gerader Kantenstücke.

Signatur

detect_edge_segments(Image : : SobelSize, MinAmplitude, MaxDistance, MinLength : BeginRow, BeginCol, EndRow, EndCol)

detect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegmentsDetectEdgeSegments detektiert gerade Kantenstücke in einem Graustufenbild. Die gefundenen Kantensegmente werden als Strecken Linien) mit einem Anfangs-(BeginRowBeginRowBeginRowBeginRowbeginRow,BeginColBeginColBeginColBeginColbeginCol) und einem Endpunkt (EndRowEndRowEndRowEndRowendRow,EndColEndColEndColEndColendCol) zurückgeliefert. Die Kantendetektion basiert auf dem Sobelfilter (Variante 'sum_abs', Filtergröße, gemäß SobelSizeSobelSizeSobelSizeSobelSizesobelSize). Auf dessen Filterantwort bezieht sich auch der Parameter MinAmplitudeMinAmplitudeMinAmplitudeMinAmplitudeminAmplitude: Nur Pixel mit Intensität größer oder gleich MinAmplitudeMinAmplitudeMinAmplitudeMinAmplitudeminAmplitude im gefilterten Eingangsbild werden als Kanditaten für Kantenpunkte verwendet. Die Rohkanten werden verdünnt und in gerade Teilstücke zerlegt. Aus technischen Gründen gehen dabei Kantenpunkte, in denen sich mehrere Kanten treffen, verloren. Somit liefert detect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegmentsDetectEdgeSegments im allgemeinen keine geschlossenen Objektkonturen (bzw. lineare Approximationen daran). Der Parameter MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance steuert die Zerlegung von Kanten in gerade Teilstücke. Er gibt die maximale Abweichung eines Kantenpunktes von der approximierenden Geraden an. Aus Laufzeitgründen wird dabei nicht der euklidische Abstand, sondern die Betragssumme der Koordinatendifferenzen verwendet. MinLengthMinLengthMinLengthMinLengthminLength gibt die gewünschte Mindestlänge der Ausgabelinien an. Kürzere Linien werden unterdrückt.

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

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

Parameter

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte)

Eingabebild.

SobelSizeSobelSizeSobelSizeSobelSizesobelSize (input_control) integer → (integer)

Filtergröße für Sobeloperator.

Defaultwert: 5

Werteliste: 3, 5, 7, 9, 11, 13

MinAmplitudeMinAmplitudeMinAmplitudeMinAmplitudeminAmplitude (input_control) integer → (integer)

Mindestamplitude für Kanten.

Defaultwert: 32

Wertevorschläge: 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 80, 90, 100, 110

Typischer Wertebereich: 1 ≤ MinAmplitude MinAmplitude MinAmplitude MinAmplitude minAmplitude ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: MinAmplitude >= 0

MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance (input_control) integer → (integer)

Maximale Abweichung der approximierenden Geraden von der ursprünglichen Kante.

Defaultwert: 3

Wertevorschläge: 2, 3, 4, 5, 6, 7, 8

Typischer Wertebereich: 1 ≤ MaxDistance MaxDistance MaxDistance MaxDistance maxDistance ≤ 30

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: MaxDistance >= 0

MinLengthMinLengthMinLengthMinLengthminLength (input_control) integer → (integer)

Mindestlänge der Ausgabelinien.

Defaultwert: 10

Wertevorschläge: 3, 5, 7, 9, 11, 13, 16, 20

Typischer Wertebereich: 1 ≤ MinLength MinLength MinLength MinLength minLength ≤ 500

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: MinLength >= 0

BeginRowBeginRowBeginRowBeginRowbeginRow (output_control) line.begin.y-array → (integer)

Zeilenkoordinaten der Anfangspunkte der Ausgabelinien.

BeginColBeginColBeginColBeginColbeginCol (output_control) line.begin.x-array → (integer)

Spaltenkoordinaten der Anfgangspunkte der Ausgabelinien.

EndRowEndRowEndRowEndRowendRow (output_control) line.end.y-array → (integer)

Zeilenkoordinaten der Endpunkte der Ausgabelinien.

EndColEndColEndColEndColendCol (output_control) line.end.x-array → (integer)

Spaltenkoordinaten der Endpunkte der Ausgabelinien.

Beispiel (C)

Htuple  SobelSize,MinAmplitude,MaxDistance,MinLength;
Htuple  RowBegin,ColBegin,RowEnd,ColEnd;

create_tuple(&SobelSize,1);
set_i(SobelSize,5,0);
create_tuple(&MinAmplitude,1);
set_i(MinAmplitude,32,0);
create_tuple(&MaxDistance,1);
set_i(MaxDistance,3,0);
create_tuple(&MinLength,1);
set_i(MinLength,10,0);
T_detect_edge_segments(Image,SobelSize,MinAmplitude,MaxDistance,MinLength,
                &RowBegin,&ColBegin,&RowEnd,&ColEnd);

Ergebnis

Sind die Parameterwerte korrekt, dann liefert detect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegmentsDetectEdgeSegments 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.

Vorgänger

sigma_imagesigma_imageSigmaImageSigmaImageSigmaImage, median_imagemedian_imageMedianImageMedianImageMedianImage

Nachfolger

partition_linespartition_linesPartitionLinesPartitionLinesPartitionLines, line_positionline_positionLinePositionLinePositionLinePosition, line_orientationline_orientationLineOrientationLineOrientationLineOrientation

Alternativen

sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, thresholdthresholdThresholdThresholdThreshold, skeletonskeletonSkeletonSkeletonSkeleton

Modul

Foundation

Operatoren