union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld (Operator)

Name

union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld — Vereinigen von benachbarten geraden Konturen mit ähnlicher Richtung.

Signatur

Beschreibung

Mit union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld werden die Konturen ContoursContoursContoursContourscontourscontours verglichen und unter gewissen Voraussetzungen vereinigt. In einem Iterationsschritt werden maximal zwei Konturen, die die entsprechenden Voraussetzungen erfüllen, vereinigt. Mit dem Parameter IterationsIterationsIterationsIterationsiterationsiterations kann gesteuert werden, wie oft dieser Vereinigungsschritt wiederholt wird.

Zwei Konturen werden vereinigt, wenn deren kürzester Endpunktabstand (die Endpunkte sind die Fußpunkte der Lote von den Konturendpunkten auf die optimale Regressionsgerade) kleiner als MaxDistMaxDistMaxDistMaxDistmaxDistmax_dist ist und wenn ihre Richtungsdifferenz (bzgl. der zugehörigen optimalen Regressionsgeraden) kleiner als MaxDiffMaxDiffMaxDiffMaxDiffmaxDiffmax_diff (Bogenmaß) ist.

Wenn nur eine der beiden Bedingungen zutrifft, kann die Entscheidung zugunsten einer Vereinigung durch die Gewichtung PercentPercentPercentPercentpercentpercent beeinflusst werden, indem die prozentuale Überschreitung des angegebenen Grenzwertes gegen die prozentuale Unterschreitung des anderen Grenzwertes angerechnet wird. Dabei wird der Endpunktabstand mit PercentPercentPercentPercentpercentpercent, die Richtungsdifferenz mit 100 - PercentPercentPercentPercentpercentpercent bewertet.

Das bedeutet, dass zwei Konturen dann vereinigt werden, wenn sie die folgende Bedingung erfüllen:

Wenn zwei Konturen beispielsweise einen minimalen Endpunktabstand von 5.0 und eine Richtungsdifferenz von 0.5 haben (bei Grenzwerten MaxDistMaxDistMaxDistMaxDistmaxDistmax_dist = 4.0 und MaxDiffMaxDiffMaxDiffMaxDiffmaxDiffmax_diff = 0.625), so weichen beide Werte von den Grenzwerten um 25% ab. Durch die Wahl von PercentPercentPercentPercentpercentpercent = 60% fällt nun der große Endpunktabstand stärker ins Gewicht als die geringe Richtungsdifferenz, weshalb die Konturen nicht vereinigt werden. Wenn in diesem Fall PercentPercentPercentPercentpercentpercent = 40% gewählt würde, würden die Konturen vereinigt werden.

Bei PercentPercentPercentPercentpercentpercent = 100% geht nur der Endpunktabstand in die Entscheidung ein, bei PercentPercentPercentPercentpercentpercent = 0% geht nur die Richtungsdifferenz in die Entscheidung ein, bei PercentPercentPercentPercentpercentpercent = 50% sind beide Merkmale gleichberechtigt.

Bei parallel verlaufenden Konturen besteht die Gefahr, dass nebeneinander liegende Konturen vereinigt werden. Soll dieser Effekt verhindert werden, so muss für ModeModeModeModemodemode 'noparallel'"noparallel""noparallel""noparallel""noparallel""noparallel", ansonsten 'paralleltoo'"paralleltoo""paralleltoo""paralleltoo""paralleltoo""paralleltoo" angegeben werden. Für 'every'"every""every""every""every""every" werden die Konturen bedingungslos vereinigt. Alle anderen Parameter haben in diesem Fall keinen Einfluss.

Für jede durch Vereinigung neu entstandene Kontur werden die Regressionsgeradenparameter neu berechnet.

Achtung

Bevor Konturen mit union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld vereinigt werden können, müssen die Regressionsgeradenparameter mit regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXldregress_contours_xld berechnet werden.

Außerdem ist zu beachten, dass union_straight_contours_xldunion_straight_contours_xldUnionStraightContoursXldUnionStraightContoursXldUnionStraightContoursXldunion_straight_contours_xld keine Konturen vereinigen kann, deren Punkte unterschiedliche Attribute aufweisen. Dieser Fall kann eintreten, wenn Konturen mit verschiedenen Operatoren extrahiert werden (z.B. mit lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss und lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet). Informationen zu den Konturattributen und in welchen Fällen diese definiert werden, können in den jeweiligen Operatorenreferenzen gefunden werden. Die Punktattribute einer Kontur können mit query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXldQueryContourAttribsXldquery_contour_attribs_xld abgefragt werden.

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

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXldregress_contours_xld

Alternativen

union_collinear_contours_xldunion_collinear_contours_xldUnionCollinearContoursXldUnionCollinearContoursXldUnionCollinearContoursXldunion_collinear_contours_xld, union_collinear_contours_ext_xldunion_collinear_contours_ext_xldUnionCollinearContoursExtXldUnionCollinearContoursExtXldUnionCollinearContoursExtXldunion_collinear_contours_ext_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

Siehe auch

fit_line_contour_xldfit_line_contour_xldFitLineContourXldFitLineContourXldFitLineContourXldfit_line_contour_xld, get_contour_xldget_contour_xldGetContourXldGetContourXldGetContourXldget_contour_xld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld, gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, get_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld, get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXldget_contour_global_attrib_xld, query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldquery_contour_global_attribs_xld

Modul

Foundation