select_gray — Auswahl von Regionen aufgrund von Grauwertmerkmalen.
select_gray hat als Eingabe eine Anzahl von Regionen
(Regions). Für jede dieser Regionen werden die Merkmale
(Features) berechnet. Wenn jedes (Operation =
'and') oder mindestens eines (Operation = 'or') der
berechneten Merkmale in den für Features festgelegten Grenzen
liegt, wird die Region in die Ausgabe SelectedRegions übernommen
(dupliziert). Die Grenzen
werden von den Parametern Min und Max definiert.
Für diese Parameter können dabei auch 'min' beziehungsweise
'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 enthält ein Bild, das die Grauwerte zur
Berechnung der Merkmale liefert.
Bedingung:
Mögliche Werte für Features:
'area': Volumen des Grauwertgebirges
(vgl. area_center_gray)
'row': Zeilenindex des Schwerpunkts des Grauwertgebirges
(vgl. area_center_gray)
'column': Spaltenindex des Schwerpunkts des Grauwertgebirges
(vgl. area_center_gray)
'ra': Hauptradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray)
'rb': Nebenradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray)
'phi': Hauptradius der äquivalenten Ellipse
(vgl. elliptic_axis_gray)
'min': Minimaler Grauwert
(vgl. min_max_gray)
'max': Maximaler Grauwert
(vgl. min_max_gray)
'median': Zentraler Grauwert
(vgl. min_max_gray, mit Percent=50)
'mean': Mittlerer Grauwert
(vgl. intensity)
'deviation': Standardabweichung der Grauwerte
(vgl. intensity)
'plane_deviation': Standardabweichung von der approximierten
Grauwertebene
(vgl. plane_deviation)
'anisotropy': Anisotropie
(vgl. entropy_gray)
'entropy': Entropie
(vgl. entropy_gray)
'fuzzy_entropy': Fuzzy-Entropie der Region
(vgl. fuzzy_entropy, mit einer Fuzzyfunktion von
Apar=0 bis Cpar=255)
'fuzzy_perimeter': Fuzzy-Umfang der Region
(vgl. fuzzy_perimeter, mit einer Fuzzyfunktion von
Apar=0 bis Cpar=255)
'moments_row': Gemischte Grauwertmomente der Zeile
(vgl. moments_gray_plane)
'moments_column': Gemischte Grauwertmomente der Spalte
(vgl. moments_gray_plane)
'alpha':Ebenengleichung, Parameter Alpha
(vgl. moments_gray_plane)
'beta': Ebenengleichung, Parameter Beta
(vgl. moments_gray_plane)
Der Operator select_gray berücksichtigt nur die mittels
Regions übergebenen Regionen und ignoriert jede Domäne, die zuvor
für das Eingabebild Image festgelegt wurde.
Wird nur ein Merkmal verwendet, dann ist der Wert von
Operation bedeutungslos. Mehrere Merkmale werden in der
Reihenfolge abgearbeitet, in der sie eingegeben werden. Es können
maximal 100 Merkmale angegeben werden.
Regions (input_object) region-array → object
Zu untersuchende Regionen.
Image (input_object) singlechannelimage → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Grauwertdaten.
SelectedRegions (output_object) region-array → object
Regionen, deren Merkmale innerhalb der Grenzen liegen.
Features (input_control) string(-array) → (string)
Namen der Merkmale.
Defaultwert: 'mean'
Werteliste: 'alpha', 'anisotropy', 'area', 'beta', 'column', 'deviation', 'entropy', 'fuzzy_entropy', 'fuzzy_perimeter', 'max', 'mean', 'median', 'min', 'moments_column', 'moments_row', 'phi', 'plane_deviation', 'ra', 'rb', 'row'
Operation (input_control) string → (string)
Logische Verknüpfung der Merkmale.
Defaultwert: 'and'
Werteliste: 'and', 'or'
Min (input_control) number(-array) → (real / integer / string)
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, 'min'
Max (input_control) number(-array) → (real / integer / string)
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, 'max'
Sei F die Fläche der Region und N die Anzahl der Merkmale, dann beträgt die Laufzeitkomplexität O(F * N).
select_gray 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>:),
das bei leerer Region mit
set_system(::'empty_region_result',<Result>:) festgelegt.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
connection,
mean_image,
entropy_image,
sobel_amp,
median_separate
select_shape,
shape_trans,
reduce_domain,
count_obj
deviation_image,
entropy_gray,
intensity,
mean_image,
min_max_gray,
select_obj
Foundation