convexityconvexityConvexityConvexityconvexity (Operator)

Name

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

Signatur

convexity(Regions : : : Convexity)

Herror convexity(const Hobject Regions, double* Convexity)

Herror T_convexity(const Hobject Regions, Htuple* Convexity)

void Convexity(const HObject& Regions, HTuple* Convexity)

HTuple HRegion::Convexity() const

static void HOperatorSet.Convexity(HObject regions, out HTuple convexity)

HTuple HRegion.Convexity()

def convexity(regions: HObject) -> Sequence[float]

def convexity_s(regions: HObject) -> float

Beschreibung

convexityconvexityConvexityConvexityConvexityconvexity berechnet die Konvexität jeder Eingaberegion aus RegionsRegionsRegionsRegionsregionsregions.

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 convexityconvexityConvexityConvexityConvexityconvexity (soweit kein anderes Verhalten festgelegt wurde (siehe set_systemset_systemSetSystemSetSystemSetSystemset_system)) 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

Parameter

RegionsRegionsRegionsRegionsregionsregions (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Zu untersuchende Region(en).

ConvexityConvexityConvexityConvexityconvexityconvexity (output_control)  real(-array) HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Konvexität der Eingaberegion(en).

Zusicherung: Convexity <= 1

Ergebnis

convexityconvexityConvexityConvexityConvexityconvexity liefert den Wert 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>)set_system("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>)set_system("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection

Siehe auch

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, shape_transshape_transShapeTransShapeTransShapeTransshape_trans

Modul

Foundation