select_grayselect_graySelectGraySelectGray (Operator)

Name

select_grayselect_graySelectGraySelectGray — Auswahl von Regionen aufgrund von Grauwertmerkmalen.

Signatur

select_gray(Regions, Image : SelectedRegions : Features, Operation, Min, Max : )

Herror select_gray(const Hobject Regions, const Hobject Image, Hobject* SelectedRegions, const char* Features, const char* Operation, double Min, double Max)

Herror T_select_gray(const Hobject Regions, const Hobject Image, Hobject* SelectedRegions, const Htuple Features, const Htuple Operation, const Htuple Min, const Htuple Max)

void SelectGray(const HObject& Regions, const HObject& Image, HObject* SelectedRegions, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max)

HRegion HRegion::SelectGray(const HImage& Image, const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const

HRegion HRegion::SelectGray(const HImage& Image, const HString& Features, const HString& Operation, double Min, double Max) const

HRegion HRegion::SelectGray(const HImage& Image, const char* Features, const char* Operation, double Min, double Max) const

HRegion HRegion::SelectGray(const HImage& Image, const wchar_t* Features, const wchar_t* Operation, double Min, double Max) const   (Nur Windows)

static void HOperatorSet.SelectGray(HObject regions, HObject image, out HObject selectedRegions, HTuple features, HTuple operation, HTuple min, HTuple max)

HRegion HRegion.SelectGray(HImage image, HTuple features, string operation, HTuple min, HTuple max)

HRegion HRegion.SelectGray(HImage image, string features, string operation, double min, double max)

Beschreibung

select_grayselect_graySelectGraySelectGraySelectGray hat als Eingabe eine Anzahl von Regionen (RegionsRegionsRegionsRegionsregions). Für jede dieser Regionen werden die Merkmale (FeaturesFeaturesFeaturesFeaturesfeatures) berechnet. Wenn jedes (OperationOperationOperationOperationoperation = 'and') oder mindestens eines (OperationOperationOperationOperationoperation = 'or') der berechneten Merkmale in den für FeaturesFeaturesFeaturesFeaturesfeatures festgelegten Grenzen liegt, wird die Region in die Ausgabe SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions übernommen (dupliziert). Die Grenzen werden von den Parametern MinMinMinMinmin und MaxMaxMaxMaxmax definiert. Für diese Parameter können dabei auch 'min'"min""min""min""min" beziehungsweise 'max'"max""max""max""max" als Werte gesetzt werden, wodurch die Grenze auf den niedrigsten beziehungsweise höchsten für dieses Merkmal möglichen Wert gesetzt wird. Der Parameter ImageImageImageImageimage enthält ein Bild, das die Grauwerte zur Berechnung der Merkmale liefert. Bedingung: Mögliche Werte für FeaturesFeaturesFeaturesFeaturesfeatures:

'area'

Volumen des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'row'

Zeilenindex des Schwerpunkts des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'column'

Spaltenindex des Schwerpunkts des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'ra'

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'rb'

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'phi'

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'min'

Minimaler Grauwert (vgl. min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray)

'max'

Maximaler Grauwert (vgl. min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray)

'median'

Zentraler Grauwert (vgl. min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, mit Percent=50)

'mean'

Mittlerer Grauwert (vgl. intensityintensityIntensityIntensityIntensity)

'deviation'

Standardabweichung der Grauwerte (vgl. intensityintensityIntensityIntensityIntensity)

'plane_deviation'

Standardabweichung von der approximierten Grauwertebene (vgl. plane_deviationplane_deviationPlaneDeviationPlaneDeviationPlaneDeviation)

'anisotropy'

Anisotropie (vgl. entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray)

'entropy'

Entropie (vgl. entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray)

'fuzzy_entropy'

Fuzzy-Entropie der Region (vgl. fuzzy_entropyfuzzy_entropyFuzzyEntropyFuzzyEntropyFuzzyEntropy, mit einer Fuzzyfunktion von Apar=0 bis Cpar=255)

'fuzzy_perimeter'

Fuzzy-Umfang der Region (vgl. fuzzy_perimeterfuzzy_perimeterFuzzyPerimeterFuzzyPerimeterFuzzyPerimeter, mit einer Fuzzyfunktion von Apar=0 bis Cpar=255)

'moments_row'

Gemischte Grauwertmomente der Zeile (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'moments_column'

Gemischte Grauwertmomente der Spalte (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'alpha'

Ebenengleichung, Parameter Alpha (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'beta'

Ebenengleichung, Parameter Beta (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

Achtung

Der Operator select_grayselect_graySelectGraySelectGraySelectGray berücksichtigt nur die mittels RegionsRegionsRegionsRegionsregions übergebenen Regionen und ignoriert jede Domäne, die zuvor für das Eingabebild ImageImageImageImageimage festgelegt wurde. Wird nur ein Merkmal verwendet, dann ist der Wert von OperationOperationOperationOperationoperation bedeutungslos. Mehrere Merkmale werden in der Reihenfolge abgearbeitet, in der sie eingegeben werden. Es können maximal 100 Merkmale angegeben werden.

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregions (input_object)  region-array objectHRegionHRegionHobject

Zu untersuchende Regionen.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Grauwertdaten.

SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions (output_object)  region-array objectHRegionHRegionHobject *

Regionen, deren Merkmale innerhalb der Grenzen liegen.

FeaturesFeaturesFeaturesFeaturesfeatures (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Namen der Merkmale.

Defaultwert: 'mean' "mean" "mean" "mean" "mean"

Werteliste: 'alpha'"alpha""alpha""alpha""alpha", 'anisotropy'"anisotropy""anisotropy""anisotropy""anisotropy", 'area'"area""area""area""area", 'beta'"beta""beta""beta""beta", 'column'"column""column""column""column", 'deviation'"deviation""deviation""deviation""deviation", 'entropy'"entropy""entropy""entropy""entropy", 'fuzzy_entropy'"fuzzy_entropy""fuzzy_entropy""fuzzy_entropy""fuzzy_entropy", 'fuzzy_perimeter'"fuzzy_perimeter""fuzzy_perimeter""fuzzy_perimeter""fuzzy_perimeter", 'max'"max""max""max""max", 'mean'"mean""mean""mean""mean", 'median'"median""median""median""median", 'min'"min""min""min""min", 'moments_column'"moments_column""moments_column""moments_column""moments_column", 'moments_row'"moments_row""moments_row""moments_row""moments_row", 'phi'"phi""phi""phi""phi", 'plane_deviation'"plane_deviation""plane_deviation""plane_deviation""plane_deviation", 'ra'"ra""ra""ra""ra", 'rb'"rb""rb""rb""rb", 'row'"row""row""row""row"

OperationOperationOperationOperationoperation (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Logische Verknüpfung der Merkmale.

Defaultwert: 'and' "and" "and" "and" "and"

Werteliste: 'and'"and""and""and""and", 'or'"or""or""or""or"

MinMinMinMinmin (input_control)  number(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Untergrenze(n) der Merkmale oder 'min'.

Defaultwert: 128.0

Wertevorschläge: 0.5, 1.0, 10.0, 20.0, 50.0, 128.0, 255.0, 1000.0

MaxMaxMaxMaxmax (input_control)  number(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Obergrenze(n) der Merkmale oder 'max'.

Defaultwert: 255.0

Wertevorschläge: 0.5, 1.0, 10.0, 20.0, 50.0, 128.0, 255.0, 1000.0

Komplexität

Sei F die Fläche der Region und N die Anzahl der Merkmale, dann beträgt die Laufzeitkomplexität O(F * N).

Ergebnis

select_grayselect_graySelectGraySelectGraySelectGray liefert den Wert 2 (H_MSG_TRUE), falls das Eingabebild definierte Grauwerten besitzt und die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabebilder) wird mit 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>), das bei leerer Region 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>) festgelegt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

connectionconnectionConnectionConnectionConnection, mean_imagemean_imageMeanImageMeanImageMeanImage, entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparate

Nachfolger

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, shape_transshape_transShapeTransShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, count_objcount_objCountObjCountObjCountObj

Siehe auch

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray, intensityintensityIntensityIntensityIntensity, mean_imagemean_imageMeanImageMeanImageMeanImage, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, select_objselect_objSelectObjSelectObjSelectObj

Modul

Foundation