union_collinear_contours_ext_xldunion_collinear_contours_ext_xldUnionCollinearContoursExtXldUnionCollinearContoursExtXldunion_collinear_contours_ext_xld (Operator)

Name

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

Signatur

Beschreibung

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

Parameter

Die Parameter MaxDistAbsMaxDistAbsMaxDistAbsMaxDistAbsmaxDistAbsmax_dist_abs, MaxDistRelMaxDistRelMaxDistRelMaxDistRelmaxDistRelmax_dist_rel, MaxShiftMaxShiftMaxShiftMaxShiftmaxShiftmax_shift und MaxAngleMaxAngleMaxAngleMaxAnglemaxAnglemax_angle sind identisch wie wie beim Operator union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXldunion_collinear_contours_xld beschrieben.

MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlapmax_overlap

Zusätzlich lässt sich hier mit MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlapmax_overlap 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 MaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlapmax_overlap übergebenen Parameter -- die Konturen nicht um mehr als ein Drittel ihrer Länge überlappen.

MaxRegrErrorMaxRegrErrorMaxRegrErrorMaxRegrErrormaxRegrErrormax_regr_error

Der Parameter MaxRegrErrorMaxRegrErrorMaxRegrErrorMaxRegrErrormaxRegrErrormax_regr_error 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).

MaxCostsMaxCostsMaxCostsMaxCostsmaxCostsmax_costs

Mit dem Parameter MaxCostsMaxCostsMaxCostsMaxCostsmaxCostsmax_costs 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.

WeightDistWeightDistWeightDistWeightDistweightDistweight_dist, WeightShiftWeightShiftWeightShiftWeightShiftweightShiftweight_shift, WeightAngleWeightAngleWeightAngleWeightAngleweightAngleweight_angle, WeightLinkWeightLinkWeightLinkWeightLinkweightLinkweight_link, and WeightRegrWeightRegrWeightRegrWeightRegrweightRegrweight_regr

Der Einfluss der verschiedenen Messwerte auf die Gesamtkosten wird durch die Übergabe einer entsprechenden Gewichtung mit Hilfe der Parameter WeightDistWeightDistWeightDistWeightDistweightDistweight_dist, WeightShiftWeightShiftWeightShiftWeightShiftweightShiftweight_shift, WeightAngleWeightAngleWeightAngleWeightAngleweightAngleweight_angle, WeightLinkWeightLinkWeightLinkWeightLinkweightLinkweight_link und WeightRegrWeightRegrWeightRegrWeightRegrweightRegrweight_regr eingestellt. Dabei ist zu beachten, dass die Gesamtkosten immer auf 1 normiert werden. Der Parameter WeightRegrWeightRegrWeightRegrWeightRegrweightRegrweight_regr wird z.Zt. nicht verwendet.

ModeModeModeModemodemode

Der Parameter ModeModeModeModemodemode steuert -- wie beim Operator union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXldunion_collinear_contours_xld -- 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_xldSplitContoursXldSplitContoursXldSplitContoursXldsplit_contours_xld, select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXldselect_contours_xld

Alternativen

union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXldunion_collinear_contours_xld, union_cocircular_contours_xldunion_cocircular_contours_xldUnionCocircularContoursXldUnionCocircularContoursXldUnionCocircularContoursXldunion_cocircular_contours_xld, union_cotangential_contours_xldunion_cotangential_contours_xldUnionCotangentialContoursXldUnionCotangentialContoursXldUnionCotangentialContoursXldunion_cotangential_contours_xld, union_adjacent_contours_xldunion_adjacent_contours_xldUnionAdjacentContoursXldUnionAdjacentContoursXldUnionAdjacentContoursXldunion_adjacent_contours_xld, union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld

Siehe auch

edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix, gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXldgen_polygons_xld, split_contours_xldsplit_contours_xldSplitContoursXldSplitContoursXldSplitContoursXldsplit_contours_xld, select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXldselect_contours_xld, get_contour_xldget_contour_xldGetContourXldGetContourXldGetContourXldget_contour_xld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld

Modul

Foundation