circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld (Operator)

Name

circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld — Formfaktor für die Kreisförmigkeit von Konturen bzw. Polygonen.

Signatur

Beschreibung

circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld berechnet für jede Eingabekontur bzw. jedes Eingabepolygon die Ähnlichkeit mit einem Kreis. Es muss darauf geachtet werden, dass sich die Eingabekonturen bzw. -polygone nicht selbst schneiden, da ansonsten der Ausgabeparameter keinen aussagekräftigen Wert enthält (Ob sich die Eingabekonturen selbst schneiden oder nicht, lässt sich mit test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld überprüfen). Ist eine Eingabekontur oder ein Eingabepolygon nicht geschlossen, so wird sie/es vor der Berechnung automatisch geschlossen.

Berechnung: Sei F die eingeschlossene Fläche der Kontur bzw. des Polygons und max der maximale Abstand vom Schwerpunkt zu allen Kontur- bzw. Polygonpunkten, dann ist der Formfaktor CircularityCircularityCircularityCircularitycircularitycircularity definiert als: Der Formfaktor CircularityCircularityCircularityCircularitycircularitycircularity ist bei einem Kreis gleich 1. Wenn die Kontur oder das Polygon langgestreckt ist, ist CircularityCircularityCircularityCircularitycircularitycircularity kleiner als 1. circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld spricht besonders auf große Ausbuchtungen an.

Wird mehr als eine Kontur oder ein Polygon übergeben, dann werden ihre Formfaktoren in einem Tupel in der Reihenfolge ihrer entsprechenden Konturen bzw. Polygone in XLDXLDXLDXLDXLDxld abgespeichert.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.

Parameter

Ergebnis

circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld liefert den Wert 2 (H_MSG_TRUE), falls die Eingabekontur nicht leer ist. Das Verhalten bei leerer Eingabe (keine Eingabekontur vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld

Alternativen

compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXldcompactness_xld, convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld, eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld, rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXldrectangularity_xld

Siehe auch

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld

Modul

Foundation