convexityconvexityConvexityConvexity (Operator)

Name

convexityconvexityConvexityConvexity — Ermitteln des Formfaktors für die Konvexität einer Region.

Signatur

Beschreibung

convexityconvexityConvexityConvexityConvexity berechnet die Konvexität jeder Eingaberegion aus RegionsRegionsRegionsRegionsregions.

Berechnung:

Sei die Fläche der konvexen Hülle und die Originalfläche der Region, dann ist der Formfaktor C definiert als:

Der Formfaktor C ist gleich 1, wenn die Region konvex ist (z.B. Rechteck, Kreis etc.). Sind Einbuchtungen oder Hohlflächen vorhanden, dann ist C kleiner als 1.

In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie ein Bild mit Regionen, die sich in ihrer Konvexität unterscheiden.

Bei einer leeren Region liefert convexityconvexityConvexityConvexityConvexity (soweit kein anderes Verhalten festgelegt wurde (siehe set_systemset_systemSetSystemSetSystemSetSystem)) den Wert 0. Wird mehr als eine Region übergeben, dann werden die Zahlenwerte des Formfaktors in einem Tupel abgespeichert, wobei die Position eines Wertes in dem Tupel der Position der Region im Eingabetupel entspricht.

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

convexityconvexityConvexityConvexityConvexity liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe (keine Eingaberegionen 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. Das Verhalten bei einer leeren Region (Region ist die leere Menge) wird mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection

Siehe auch

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, shape_transshape_transShapeTransShapeTransShapeTrans

Modul

Foundation