hysteresis_threshold [HALCON Operator-Referenz / Version 19.11.0.0]

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold — Segmentieren von Bildern mittels Hysterese-schwellenwertoperation.

Signatur

Herror hysteresis_threshold(const Hobject Image, Hobject* RegionHysteresis, const Hlong Low, const Hlong High, const Hlong MaxLength)

Herror T_hysteresis_threshold(const Hobject Image, Hobject* RegionHysteresis, const Htuple Low, const Htuple High, const Htuple MaxLength)

void HysteresisThreshold(const HObject& Image, HObject* RegionHysteresis, const HTuple& Low, const HTuple& High, const HTuple& MaxLength)

HRegion HImage::HysteresisThreshold(const HTuple& Low, const HTuple& High, Hlong MaxLength) const

HRegion HImage::HysteresisThreshold(Hlong Low, Hlong High, Hlong MaxLength) const

Beschreibung

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThresholdHysteresisThreshold führt eine Schwellenwertoperation mit Hysterese (nach Canny) durch. Dabei werden alle Punkte im Eingabebild ImageImageImageImageimage größer oder gleich der oberen Schwelle HighHighHighHighhigh sofort in die Ausgaberegion(en) übernommen („sichere“ Punkte). Umgekehrt werden alle Punkte mit Grauwerten echt kleiner als die untere Schwelle LowLowLowLowlow zurückgewiesen. „Potentielle“ Punkte mit Grauwerten zwischen den beiden Schwellen schließlich werden dann übernommen, wenn sie durch einen Pfad mit maximaler Länge MaxLengthMaxLengthMaxLengthMaxLengthmaxLength von „potentiellen“ Punkten mit einem „sicheren“ Punkt verbunden sind. Die „sicheren“ Punkte strahlen also auf ihre Umgebung aus, sie „wirken nach“ (Hysterese).

Achtung

Bei Bildern vom Typ byte, uint2 oder int4 muss die untere Schwelle LowLowLowLowlow > 0 sein.

Ausführungsinformationen

Parameter

ImageImageImageImageimage (input_object) singlechannelimage(-array) → object (byte / uint2 / int4 / real)

Eingabebild.

RegionHysteresisRegionHysteresisRegionHysteresisRegionHysteresisregionHysteresis (output_object) region(-array) → object

segmentierte Region.

LowLowLowLowlow (input_control) number → (integer / real)

Untere Schwelle für die Grauwerte.

Defaultwert: 30

Wertevorschläge: 5, 10, 15, 20, 30, 40, 50, 60, 70, 80, 90, 100

HighHighHighHighhigh (input_control) number → (integer / real)

Obere Schwelle für die Grauwerte.

Defaultwert: 60

Wertevorschläge: 5, 10, 15, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130

Restriktion: High >= Low

MaxLengthMaxLengthMaxLengthMaxLengthmaxLength (input_control) integer → (integer)

Maximale Länge eines Pfades „potentieller“ Punkte zu einem „sicheren“ Punkt hin.

Defaultwert: 10

Wertevorschläge: 1, 2, 3, 5, 7, 10, 12, 14, 17, 20, 25, 30, 35, 40, 50

Typischer Wertebereich: 1 ≤ MaxLength MaxLength MaxLength MaxLength maxLength

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5

Restriktion: MaxLength > 1

Ergebnis

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThresholdHysteresisThreshold liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Für das Verhalten bzgl. der Eingabebilder und Ausgaberegionen sind die Flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result", 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result" und 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemSetSystemSetSystem). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Alternativen

Siehe auch

Literatur

J. Canny, „Finding Edges and Lines in Images“; Report, AI-TR-720, M.I.T. Artificial Intelligence Lab., Cambridge, MA, 1983.

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold (Operator)

Name