select_gray select_gray SelectGray SelectGray (Operator)
Name
select_gray select_gray SelectGray SelectGray
— Auswahl von Regionen aufgrund von Grauwertmerkmalen.
Signatur
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_gray select_gray SelectGray SelectGray SelectGray
hat als Eingabe eine Anzahl von Regionen
(Regions Regions Regions Regions regions
). Für jede dieser Regionen werden die Merkmale
(Features Features Features Features features
) berechnet. Wenn jedes (Operation Operation Operation Operation operation
=
'and') oder mindestens eines (Operation Operation Operation Operation operation
= 'or') der
berechneten Merkmale in den für Features Features Features Features features
festgelegten Grenzen
liegt, wird die Region in die Ausgabe SelectedRegions SelectedRegions SelectedRegions SelectedRegions selectedRegions
übernommen
(dupliziert). Die Grenzen
werden von den Parametern Min Min Min Min min
und Max Max Max Max max
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 Image Image Image Image image
enthält ein Bild, das die Grauwerte zur
Berechnung der Merkmale liefert.
Bedingung:
Mögliche Werte für Features Features Features Features features
:
'area'
Volumen des Grauwertgebirges
(vgl. area_center_gray area_center_gray AreaCenterGray AreaCenterGray AreaCenterGray
)
'row'
Zeilenindex des Schwerpunkts des Grauwertgebirges
(vgl. area_center_gray area_center_gray AreaCenterGray AreaCenterGray AreaCenterGray
)
'column'
Spaltenindex des Schwerpunkts des Grauwertgebirges
(vgl. area_center_gray area_center_gray AreaCenterGray AreaCenterGray AreaCenterGray
)
'ra'
Hauptradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray elliptic_axis_gray EllipticAxisGray EllipticAxisGray EllipticAxisGray
)
'rb'
Nebenradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray elliptic_axis_gray EllipticAxisGray EllipticAxisGray EllipticAxisGray
)
'phi'
Hauptradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray elliptic_axis_gray EllipticAxisGray EllipticAxisGray EllipticAxisGray
)
'min'
Minimaler Grauwert (vgl. min_max_gray min_max_gray MinMaxGray MinMaxGray MinMaxGray
)
'max'
Maximaler Grauwert (vgl. min_max_gray min_max_gray MinMaxGray MinMaxGray MinMaxGray
)
'median'
Zentraler Grauwert (vgl. min_max_gray min_max_gray MinMaxGray MinMaxGray MinMaxGray
,
mit Percent=50)
'mean'
Mittlerer Grauwert (vgl. intensity intensity Intensity Intensity Intensity
)
'deviation'
Standardabweichung der Grauwerte
(vgl. intensity intensity Intensity Intensity Intensity
)
'plane_deviation'
Standardabweichung von der approximierten
Grauwertebene (vgl. plane_deviation plane_deviation PlaneDeviation PlaneDeviation PlaneDeviation
)
'anisotropy'
Anisotropie (vgl. entropy_gray entropy_gray EntropyGray EntropyGray EntropyGray
)
'entropy'
Entropie (vgl. entropy_gray entropy_gray EntropyGray EntropyGray EntropyGray
)
'fuzzy_entropy'
Fuzzy-Entropie der Region
(vgl. fuzzy_entropy fuzzy_entropy FuzzyEntropy FuzzyEntropy FuzzyEntropy
, mit einer
Fuzzyfunktion von Apar=0 bis Cpar=255)
'fuzzy_perimeter'
Fuzzy-Umfang der Region
(vgl. fuzzy_perimeter fuzzy_perimeter FuzzyPerimeter FuzzyPerimeter FuzzyPerimeter
, mit einer
Fuzzyfunktion von Apar=0 bis Cpar=255)
'moments_row'
Gemischte Grauwertmomente der Zeile
(vgl. moments_gray_plane moments_gray_plane MomentsGrayPlane MomentsGrayPlane MomentsGrayPlane
)
'moments_column'
Gemischte Grauwertmomente der Spalte
(vgl. moments_gray_plane moments_gray_plane MomentsGrayPlane MomentsGrayPlane MomentsGrayPlane
)
'alpha'
Ebenengleichung, Parameter Alpha
(vgl. moments_gray_plane moments_gray_plane MomentsGrayPlane MomentsGrayPlane MomentsGrayPlane
)
'beta'
Ebenengleichung, Parameter Beta
(vgl. moments_gray_plane moments_gray_plane MomentsGrayPlane MomentsGrayPlane MomentsGrayPlane
)
Achtung
Der Operator select_gray select_gray SelectGray SelectGray SelectGray
berücksichtigt nur die mittels
Regions Regions Regions Regions regions
übergebenen Regionen und ignoriert jede Domäne, die zuvor
für das Eingabebild Image Image Image Image image
festgelegt wurde.
Wird nur ein Merkmal verwendet, dann ist der Wert von
Operation Operation Operation Operation operation
bedeutungslos. Mehrere Merkmale werden in der
Reihenfolge abgearbeitet, in der sie eingegeben werden. Es können
maximal 100 Merkmale angegeben werden.
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
Regions Regions Regions Regions regions
(input_object) region-array →
object HRegion HRegion Hobject
Zu untersuchende Regionen.
Image Image Image Image image
(input_object) singlechannelimage →
object HImage HImage Hobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Grauwertdaten.
SelectedRegions SelectedRegions SelectedRegions SelectedRegions selectedRegions
(output_object) region-array →
object HRegion HRegion Hobject *
Regionen, deren Merkmale innerhalb der Grenzen liegen.
Features Features Features Features features
(input_control) string(-array) →
HTuple HTuple Htuple (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"
Operation Operation Operation Operation operation
(input_control) string →
HTuple HTuple Htuple (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"
Min Min Min Min min
(input_control) number(-array) →
HTuple HTuple Htuple (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
Max Max Max Max max
(input_control) number(-array) →
HTuple HTuple Htuple (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_gray select_gray SelectGray SelectGray SelectGray
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
connection connection Connection Connection Connection
,
mean_image mean_image MeanImage MeanImage MeanImage
,
entropy_image entropy_image EntropyImage EntropyImage EntropyImage
,
sobel_amp sobel_amp SobelAmp SobelAmp SobelAmp
,
median_separate median_separate MedianSeparate MedianSeparate MedianSeparate
Nachfolger
select_shape select_shape SelectShape SelectShape SelectShape
,
shape_trans shape_trans ShapeTrans ShapeTrans ShapeTrans
,
reduce_domain reduce_domain ReduceDomain ReduceDomain ReduceDomain
,
count_obj count_obj CountObj CountObj CountObj
Siehe auch
deviation_image deviation_image DeviationImage DeviationImage DeviationImage
,
entropy_gray entropy_gray EntropyGray EntropyGray EntropyGray
,
intensity intensity Intensity Intensity Intensity
,
mean_image mean_image MeanImage MeanImage MeanImage
,
min_max_gray min_max_gray MinMaxGray MinMaxGray MinMaxGray
,
select_obj select_obj SelectObj SelectObj SelectObj
Modul
Foundation