KlassenKlassenKlassenKlassen | | | | Operatoren

select_grayselect_graySelectGrayselect_graySelectGraySelectGray (Operator)

Name

select_grayselect_graySelectGrayselect_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)

Herror select_gray(Hobject Regions, Hobject Image, Hobject* SelectedRegions, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max)

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

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

void HOperatorSetX.SelectGray(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*SelectedRegions, [in] VARIANT Features, [in] VARIANT Operation, [in] VARIANT Min, [in] VARIANT Max)

IHRegionX* HRegionX.SelectGray(
[in] IHImageX* Image, [in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)

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_graySelectGrayselect_graySelectGraySelectGray hat als Eingabe eine Anzahl von Regionen (RegionsRegionsRegionsRegionsRegionsregions). Für jede dieser Regionen werden die Merkmale (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) berechnet. Wenn jedes (OperationOperationOperationOperationOperationoperation = 'and') oder mindestens eines (OperationOperationOperationOperationOperationoperation = 'or') der berechneten Merkmale in den für FeaturesFeaturesFeaturesFeaturesFeaturesfeatures festgelegten Grenzen liegt, wird die Region in die Ausgabe SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions übernommen (dupliziert). Die Grenzen werden von den Parametern MinMinMinMinMinmin und MaxMaxMaxMaxMaxmax definiert. Für diese Parameter können dabei auch 'min'"min""min""min""min""min" beziehungsweise 'max'"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 ImageImageImageImageImageimage enthält ein Bild, das die Grauwerte zur Berechnung der Merkmale liefert. Bedingung:

Mögliche Werte für FeaturesFeaturesFeaturesFeaturesFeaturesfeatures:

'area'

Volumen des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'row'

Zeilenindex des Schwerpunkts des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'column'

Spaltenindex des Schwerpunkts des Grauwertgebirges (vgl. area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'ra'

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'rb'

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'phi'

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'min'

Minimaler Grauwert (vgl. min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray)

'max'

Maximaler Grauwert (vgl. min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray)

'median'

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

'mean'

Mittlerer Grauwert (vgl. intensityintensityIntensityintensityIntensityIntensity)

'deviation'

Standardabweichung der Grauwerte (vgl. intensityintensityIntensityintensityIntensityIntensity)

'plane_deviation'

Standardabweichung von der approximierten Grauwertebene (vgl. plane_deviationplane_deviationPlaneDeviationplane_deviationPlaneDeviationPlaneDeviation)

'anisotropy'

Anisotropie (vgl. entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray)

'entropy'

Entropie (vgl. entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray)

'fuzzy_entropy'

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

'fuzzy_perimeter'

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

'moments_row'

Gemischte Grauwertmomente der Zeile (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'moments_column'

Gemischte Grauwertmomente der Spalte (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'alpha'

Ebenengleichung, Parameter Alpha (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'beta'

Ebenengleichung, Parameter Beta (vgl. moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

Achtung

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

Parallelisierung

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject

Zu untersuchende Regionen.

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Grauwertdaten.

SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions (output_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject *

Regionen, deren Merkmale innerhalb der Grenzen liegen.

FeaturesFeaturesFeaturesFeaturesFeaturesfeatures (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der Merkmale.

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

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

OperationOperationOperationOperationOperationoperation (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Logische Verknüpfung der Merkmale.

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

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

MinMinMinMinMinmin (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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

MaxMaxMaxMaxMaxmax (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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_graySelectGrayselect_graySelectGraySelectGray 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>)set_system("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festgelegt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

connectionconnectionConnectionconnectionConnectionConnection, mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage, entropy_imageentropy_imageEntropyImageentropy_imageEntropyImageEntropyImage, sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, median_separatemedian_separateMedianSeparatemedian_separateMedianSeparateMedianSeparate

Nachfolger

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, shape_transshape_transShapeTransshape_transShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, count_objcount_objCountObjcount_objCountObjCountObj

Siehe auch

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage, entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray, intensityintensityIntensityintensityIntensityIntensity, mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage, min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray, select_objselect_objSelectObjselect_objSelectObjSelectObj

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren