eccentricity_xldeccentricity_xldEccentricityXldEccentricityXld (Operator)

Name

eccentricity_xldeccentricity_xldEccentricityXldEccentricityXld — Aus den Ellipsenparametern abgeleitete Formmerkmale von Konturen bzw. Polygonen.

Signatur

Beschreibung

eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld berechnet die drei Formmerkmale AnisometryAnisometryAnisometryAnisometryanisometry, BulkinessBulkinessBulkinessBulkinessbulkiness und StructureFactorStructureFactorStructureFactorStructureFactorstructureFactor, die aus den geometrischen Momenten hergeleitet sind, für jede Eingabekontur bzw. jedes Eingabepolyon. Ist die Eingabekontur oder das Eingabepolygon nicht geschlossen, so wird sie/es vor der Berechnung automatisch geschlossen.

Berechnung: Seien die Ellipsenradien Ra, Rb (siehe elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld) und die eingeschlossene Fläche F der Kontur bzw. des Polygons gegeben, dann gilt: Die Anisometrie eines Kreises ist 1.0.

Es ist zu beachten, dass eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld nur dann sinnvolle Ergebnisse liefert, falls die Kontur oder das Polygon eine Fläche in der Ebene einschließt. Insbesondere darf sich die Kontur oder das Polygon nicht selbst schneiden. Dies ist insbesondere dann zu beachten, wenn offene Konturen und Polygone übergeben werden, da diese automatisch geschlossen werden, was dazu führen kann, dass sich die Kontur oder das Polygon selbst schneidet. Ob sich die Konturen oder Polygone selbst schneiden, kann leicht mit test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld überprüft werden. Falls sich die Kontur oder das Polygon selbst schneidet, kann ein sinnvoller Wert für die Anisometrie mit eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXld berechnet werden.

Wird mehr als eine Kontur oder ein Polygon übergeben, dann werden die Ergebnisse in Tupeln in der Reihenfolge ihrer entsprechenden Konturen bzw. Polygone in XLDXLDXLDXLDXLD 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

eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe 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>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld

Alternativen

eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXld

Siehe auch

elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXld, area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld

Modul

Foundation