eccentricityeccentricityEccentricityEccentricity (Operator)

Name

eccentricityeccentricityEccentricityEccentricity — Ermitteln der aus den Ellipsenparametern abgeleiteten Formmerkmale.

Signatur

eccentricity(Regions : : : Anisometry, Bulkiness, StructureFactor)

Herror eccentricity(const Hobject Regions, double* Anisometry, double* Bulkiness, double* StructureFactor)

Herror T_eccentricity(const Hobject Regions, Htuple* Anisometry, Htuple* Bulkiness, Htuple* StructureFactor)

void Eccentricity(const HObject& Regions, HTuple* Anisometry, HTuple* Bulkiness, HTuple* StructureFactor)

HTuple HRegion::Eccentricity(HTuple* Bulkiness, HTuple* StructureFactor) const

double HRegion::Eccentricity(double* Bulkiness, double* StructureFactor) const

static void HOperatorSet.Eccentricity(HObject regions, out HTuple anisometry, out HTuple bulkiness, out HTuple structureFactor)

HTuple HRegion.Eccentricity(out HTuple bulkiness, out HTuple structureFactor)

double HRegion.Eccentricity(out double bulkiness, out double structureFactor)

Beschreibung

eccentricityeccentricityEccentricityEccentricityEccentricity berechnet für die Regionen in RegionsRegionsRegionsRegionsregions die drei Formmerkmale AnisometryAnisometryAnisometryAnisometryanisometry, BulkinessBulkinessBulkinessBulkinessbulkiness und StructureFactorStructureFactorStructureFactorStructureFactorstructureFactor: wobei Ra und Rb die Ellipsenradien bezeichnen (siehe elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis) und F für die Fläche der Region steht (siehe area_centerarea_centerAreaCenterAreaCenterAreaCenter).

In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie ein Bild mit Regionen, die sich in AnisometryAnisometryAnisometryAnisometryanisometry, BulkinessBulkinessBulkinessBulkinessbulkiness und StructureFactorStructureFactorStructureFactorStructureFactorstructureFactor unterscheiden.

Wird mehr als eine Region übergeben, dann werden die Ergebnisse in Tupeln abgespeichert, wobei der Index eines Wertes in dem Tupel dem Index einer Region in der Eingabe entspricht.

Bei leerer Region haben alle Parameter den Wert 0.0, soweit kein anderes Verhalten eingestellt wurde (siehe set_systemset_systemSetSystemSetSystemSetSystem).

Achtung

Es ist zu beachten, dass, wie bei allen regionenmomentenbasierten Operatoren, die Pixel als mathematische Punkte ohne flächenhafte Ausdehnung betrachtet werden, die durch die Mitte des jeweiligen Pixels gegeben sind (siehe die Dokumentation von elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis). Dies kann dazu führen, dass nichtleere Regionen einen Wert RbRbRbRbrb = 0 besitzen. In diesem Fall werden die Ausgabemerkmale, die eine Division durch RbRbRbRbrb erfordern, auf 0 gesetzt. Insbesondere haben also Regionen, die aus einem Punkt bestehen oder deren Punkte exakt auf einer Geraden liegen (also z.B. ein Pixel hohe horizontale Regionen oder ein Pixel breite vertikale Regionen), eine Anisometrie von 0.

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHobject

Zu untersuchende Region(en).

AnisometryAnisometryAnisometryAnisometryanisometry (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Formmerkmal (bei einem Kreis = 1.0).

Zusicherung: Anisometry >= 1.0

BulkinessBulkinessBulkinessBulkinessbulkiness (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Berechnetes Formmerkmal.

StructureFactorStructureFactorStructureFactorStructureFactorstructureFactor (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Berechnetes Formmerkmal.

Komplexität

Sei F die Fläche einer Region, dann beträgt die Laufzeitkomplexität im Mittel O(sqrt(F)).

Ergebnis

eccentricityeccentricityEccentricityEccentricityEccentricity 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

elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter

Modul

Foundation