hysteresis_threshold [HALCON Operator-Referenz / Version 13.0.4]

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

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

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

HRegionArray HImageArray::HysteresisThreshold(const HTuple& Low, const HTuple& High, const HTuple& MaxLength) const

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

void HOperatorSetX.HysteresisThreshold( [in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** RegionHysteresis, [in] VARIANT Low, [in] VARIANT High, [in] VARIANT MaxLength)

IHRegionX* HImageX.HysteresisThreshold( [in] VARIANT Low, [in] VARIANT High, [in] Hlong MaxLength)

Beschreibung

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold führt eine Schwellenwertoperation mit Hysterese (nach Canny) durch. Dabei werden alle Punkte im Eingabebild ImageImageImageImageImageimage größer oder gleich der oberen Schwelle HighHighHighHighHighhigh sofort in die Ausgaberegion(en) übernommen („sichere“ Punkte). Umgekehrt werden alle Punkte mit Grauwerten echt kleiner als die untere Schwelle LowLowLowLowLowlow zurückgewiesen. „Potentielle“ Punkte mit Grauwerten zwischen den beiden Schwellen schließlich werden dann übernommen, wenn sie durch einen Pfad mit maximaler Länge MaxLengthMaxLengthMaxLengthMaxLengthMaxLengthmaxLength 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 LowLowLowLowLowlow > 0 sein.

Parallelisierung

Parameter

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

Eingabebild.

RegionHysteresisRegionHysteresisRegionHysteresisRegionHysteresisRegionHysteresisregionHysteresis (output_object) region(-array) → object

segmentierte Region.

LowLowLowLowLowlow (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

HighHighHighHighHighhigh (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

MaxLengthMaxLengthMaxLengthMaxLengthMaxLengthmaxLength (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 maxLength

Minimale Schrittweite: 1

Empfohlene Schrittweite: 5

Restriktion: MaxLength > 1

Ergebnis

hysteresis_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold 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""no_object_result", 'empty_region_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""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemset_systemSetSystemSetSystem). 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_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold (Operator)

Name