union_collinear_contours_ext_xldunion_collinear_contours_ext_xldUnionCollinearContoursExtXldUnionCollinearContoursExtXld (Operator)

Name

union_collinear_contours_ext_xldunion_collinear_contours_ext_xldUnionCollinearContoursExtXldUnionCollinearContoursExtXld — Vereinigen von kollinearen Konturen (Operator mit erweitertem Funktionsumfang).

Signatur

Beschreibung

Wie der Operator union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXld vereinigt union_collinear_contours_ext_xldunion_collinear_contours_ext_xldUnionCollinearContoursExtXldUnionCollinearContoursExtXldUnionCollinearContoursExtXld aus einer Menge von geraden, linienförmige Konturen (ContoursContoursContoursContourscontours) diejenigen miteinander, die zueinander kollinear sind, und gibt das Ergebnis in UnionContoursUnionContoursUnionContoursUnionContoursunionContours zurück. Das grundsätzliche Verhalten ist identisch zu union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXld und wird dort beschrieben, es stehen jedoch zahlreiche weitere Parameter zur Verfügung, die es erlauben, den Vereinigungsprozess genauer zu steuern.

Parameter

Die Parameter MaxDistAbsMaxDistAbsMaxDistAbsMaxDistAbsmaxDistAbs, MaxDistRelMaxDistRelMaxDistRelMaxDistRelmaxDistRel, MaxShiftMaxShiftMaxShiftMaxShiftmaxShift und MaxAngleMaxAngleMaxAngleMaxAnglemaxAngle sind identisch wie wie beim Operator union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXld beschrieben.

MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap

Zusätzlich lässt sich hier mit MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap ein Überlappungsbereich zwischen beiden Konturen definieren, so dass auch Konturen, die sich (geringfügig) überlappen, miteinander vereinigt werden können. Intern wird dabei sichergestellt, dass sich -- unabhängig von dem mit MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap übergebenen Parameter -- die Konturen nicht um mehr als ein Drittel ihrer Länge überlappen.

MaxRegrErrorMaxRegrErrorMaxRegrErrorMaxRegrErrormaxRegrError

Der Parameter MaxRegrErrorMaxRegrErrorMaxRegrErrorMaxRegrErrormaxRegrError wird z.Zt. noch nicht verwendet. Er soll später sicherstellen, dass nach der Vereinigung zweier Konturen die resultierende Kontur nicht zu stark von ihrer Regressionsgeraden abweicht. Dieser Wert ist defaultmäßig ausgeschaltet (-1), da er unter normalen Bedingungen nicht notwendig und der Rechenaufwand sehr hoch ist. Unter bestimmten Bedingungen können jedoch Ergebniskonturen entstehen, die relativ stark um ihre Regressionsgerade schwanken („wellige“ Eingangskonturen, Shift und Winkeldifferenz nah an den -- relativ hoch eingestellten -- Grenzen, rekursive Vereinigung sehr vieler kurzer Konturen).

MaxCostsMaxCostsMaxCostsMaxCostsmaxCosts

Mit dem Parameter MaxCostsMaxCostsMaxCostsMaxCostsmaxCosts ist es möglich, die Gesamtkosten der Vereinigung zu begrenzen und so nicht nur die Vereinigung der Konturpaare auszuschließen, die in einer Disziplin die vorgegebenen Grenzwerte überschreiten, sondern auch jener, die in mehreren Disziplinen die Grenzen nur knapp einhalten können. Dabei werden die Kosten immer auf einen Wert zwischen 0 und 1 normiert, der Wert 1 bedeutet dabei, dass alle Werte auf dem jeweiligen Grenzwert liegen.

WeightDistWeightDistWeightDistWeightDistweightDist, WeightShiftWeightShiftWeightShiftWeightShiftweightShift, WeightAngleWeightAngleWeightAngleWeightAngleweightAngle, WeightLinkWeightLinkWeightLinkWeightLinkweightLink, and WeightRegrWeightRegrWeightRegrWeightRegrweightRegr

Der Einfluss der verschiedenen Messwerte auf die Gesamtkosten wird durch die Übergabe einer entsprechenden Gewichtung mit Hilfe der Parameter WeightDistWeightDistWeightDistWeightDistweightDist, WeightShiftWeightShiftWeightShiftWeightShiftweightShift, WeightAngleWeightAngleWeightAngleWeightAngleweightAngle, WeightLinkWeightLinkWeightLinkWeightLinkweightLink und WeightRegrWeightRegrWeightRegrWeightRegrweightRegr eingestellt. Dabei ist zu beachten, dass die Gesamtkosten immer auf 1 normiert werden. Der Parameter WeightRegrWeightRegrWeightRegrWeightRegrweightRegr wird z.Zt. nicht verwendet.

ModeModeModeModemode

Der Parameter ModeModeModeModemode steuert -- wie beim Operator union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXld -- die Behandlung der Attribute der Eingabekontur.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Vorgänger

split_contours_xldsplit_contours_xldSplitContoursXldSplitContoursXldSplitContoursXld, select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld

Alternativen

union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXld, union_cocircular_contours_xldunion_cocircular_contours_xldUnionCocircularContoursXldUnionCocircularContoursXldUnionCocircularContoursXld, union_cotangential_contours_xldunion_cotangential_contours_xldUnionCotangentialContoursXldUnionCotangentialContoursXldUnionCotangentialContoursXld, union_adjacent_contours_xldunion_adjacent_contours_xldUnionAdjacentContoursXldUnionAdjacentContoursXldUnionAdjacentContoursXld, union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldUnionStraightContoursXld

Siehe auch

edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix, gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld, split_contours_xldsplit_contours_xldSplitContoursXldSplitContoursXldSplitContoursXld, select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld, get_contour_xldget_contour_xldGetContourXldGetContourXldGetContourXld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld

Modul

Foundation