moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXld (Operator)

Name

moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXld — Geometrische Momente beliebiger Ordnung von Konturen oder Polygonen.

Signatur

Beschreibung

moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldMomentsAnyXld berechnet Momente beliebiger Ordnung der von Konturen oder Polygonen XLDXLDXLDXLDXLD umschlossenen Bildregionen. Die Momente werden durch Anwendung des Gaußschen Integralsatzes nur unter Verwendung der Kontur- oder Polygonpunkte berechnet, d.h. es wird keine explizite Fläche zur Berechnung erzeugt. Es wird vorausgesetzt, dass die Konturen bzw. Polygone geschlossen sind. Ist das nicht der Fall, werden sie künstlich geschlossen.

Es ist zu beachten, dass moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldMomentsAnyXld 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 Momente mit moments_any_points_xldmoments_any_points_xldMomentsAnyPointsXldMomentsAnyPointsXldMomentsAnyPointsXld berechnet werden.

Abhängig vom Parameter ModeModeModeModemode werden die berechneten Momente wie folgt nomiert: ModeModeModeModemode:

'unnormalized':

Keine Normalisierung

'unnormalized_central':

Verschiebung der Bildregion um ihren Schwerpunkt

'normalized':

Normalisierung durch die Fläche A = AreaAreaAreaAreaarea der eingeschlossenen Bildregion

'central':

Normalisierung durch die Fläche A = AreaAreaAreaAreaarea der eingeschlossenen Bildregion und zusätzlich Verschiebung der Bildregion um ihren Schwerpunkt

Für die Normierung der Momente werden ggf. drei spezielle Momente benötigt: Die Fläche AreaAreaAreaAreaarea der eingeschlossenen Bildregion sowie die Koordinaten CenterRowCenterRowCenterRowCenterRowcenterRow,CenterColCenterColCenterColCenterColcenterCol des Schwerpunktes, vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld. Außerdem erwartet moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldMomentsAnyXld den Umlaufsinn der Eingabekonturen bzw. -polygone in PointOrderPointOrderPointOrderPointOrderpointOrder (diese Werte können mit area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld berechnet werden). Wird mehr als eine Kontur oder ein Polygon übergeben, dann werden die Momente für die einzelnen Konturen bzw. Polygone hintereinander in MMMMm abgelegt.

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

Komplexität

Sei n die Anzahl der Punkte in der Kontur bzw. dem Polygon. Dann ist die Laufzeit O(n).

Ergebnis

moments_any_xldmoments_any_xldMomentsAnyXldMomentsAnyXldMomentsAnyXld liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe 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

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld, gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld, smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldSmoothContoursXld, gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldGenPolygonsXld

Alternativen

moments_xldmoments_xldMomentsXldMomentsXldMomentsXld, moments_any_points_xldmoments_any_points_xldMomentsAnyPointsXldMomentsAnyPointsXldMomentsAnyPointsXld

Siehe auch

moments_xldmoments_xldMomentsXldMomentsXldMomentsXld, area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd, area_centerarea_centerAreaCenterAreaCenterAreaCenter

Modul

Foundation