gray_histo_abs
— Verteilung der Grauwerte.
gray_histo_abs(Regions, Image : : Quantization : AbsoluteHisto)
gray_histo_abs
berechnet für das übergebene Bild
(Image
) innerhalb von Regions
das absolute
(AbsoluteHisto
)) Histogramm der Grauwerte.
Der Parameter Quantization
bestimmt die Granularität des
Histogramms und gibt an, wieviele Häufigkeitswerte
von benachbarte Grauwerten zu einem Häufigkeitswert zusammengefasst werden.
Das resultierende Histogramm
AbsoluteHisto
ist ein Tupel, dessen Indizes sich auf die
Grauwerte des Eingabebildes Image
abbilden und dessen Elemente
die Grauwerthäufigkeiten enthalten. Die Indizes i der Häufigkeitswerte
berechnen sich aus den Grauwerten g und der Quantisierung q daher durch:
wobei MIN den minimalen Grauwert bezeichnet, beispielsweise -128 für
den int1 Bildtyp. Die Größe des Tupels ergibt
sich folglich
aus dem Verhältnis vom Gauwertebereich und der Quantelung, für
int2 Bilder und der Quantelung 3.0 beispielsweise zu
.
Der Null-Grauwert wird bei den vorzeichenbehafteten Bildtypen
int1 b.z.w. int2 auf den Index 128 b.z.w.
32768 abgebildet,
negative b.z.w. positive Grauwerte haben entsprechend kleinere b.z.w.
größere Indizes.
Mit set_paint(::WindowHandle,'histogram':)
und
disp_image
kann das Histogramm auch direkt als Graphik
ausgegeben werden.
Der Operator gray_histo_abs
berücksichtigt nur die mittels
Regions
übergebenen Regionen und ignoriert jede Domäne, die zuvor
für das Eingabebild Image
festgelegt wurde.
Regions
(input_object) region(-array) →
object
Region, in der das Histogramm berechnet werden soll.
Image
(input_object) singlechannelimage →
object (byte / cyclic / direction / int1 / int2 / uint2)
Bild, dessen Grauwertverteilung berechnet werden soll.
Quantization
(input_control) number →
(real / integer)
Quantelung der Grauwerte.
Defaultwert: 1.0
Wertevorschläge: 1.0, 2.0, 3.0, 5.0, 10.0
Restriktion: Quantization >= 1.0
AbsoluteHisto
(output_control) histogram-array →
(integer)
Absolute Häufigkeiten der Grauwerte.
gray_histo_abs
liefert den Wert 2 (H_MSG_TRUE), falls das Bild definierte
Grauwerte hat 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.
histo_to_thresh
,
gen_region_histo
min_max_gray
,
intensity
,
gray_histo
,
gray_histo_range
set_paint
,
disp_image
,
histo_2dim
,
scale_image_max
,
entropy_gray
Foundation