tuple_histo_range — Berechnen der Werteverteilung eines Tupels innerhalb eines bestimmten
Wertebereichs.
tuple_histo_range erstellt die Werteverteilung Histo
des Tupels Tuple im Wertebereich [Min,Max].
Die Werte für Min und Max werden abgerundet falls alle
Einträge des Tupels Tuple vom Datentyp integer (Ganzzahl)
sind.
Der Wertebereich wird in NumBins gleichgroße Klassen aufgeteilt.
Die Größe einer solchen Klasse wird in BinSize ausgegeben. Liegt
ein Wert zwischen zwei Klassen wird er immer der kleineren Klasse zugeordnet.
Bei einem Tupel mit Einträgen vom Datentyp real (Gleitkommazahl) ist
die Klassengröße
. Sind alle Einträge vom Datentyp integer (Ganzzahl) wird die
Klassengröße über
berechnet.
Falls eines oder mehrere Eingabetupel leer sind, wird eine Fehlermeldung angezeigt.
Bei Tupeln, die nur Daten vom Typ integer (Ganzzahl) enthalten
kann es in
Abhängigkeit von BinSize zu den folgenden Effekten kommen:
Für BinSize > 1 werden mehrere aufeinanderfolgende
Zahlen der selben Klasse zugeordnet. Ist BinSize dabei keine
natürliche Zahl werden die Zahlen ungleichmäßig auf die Klassen
verteilt (Für BinSize = 1.5 werden beispielsweise die
ersten beiden Zahlen der ersten Klasse, die dritte Zahl der zweiten Klasse
und die vierte und fünfte Zahl der dritten Klasse zugeordnet). Dies macht
sich durch einzelne Spitzen im Histogramm Histo bemerkbar.
Gilt BinSize < 1 werden je nach BinSize einigen
Klassen keine Zahlen zugeordnet (Für BinSize = 0.5 wird
beispielsweise die erste Zahl der ersten Klasse und die zweite Zahl der
dritten Klasse zugeordnet). Das Histogramm Histo weist dann einige
Lücken auf, was der Strukur eines Kamms ähnelt.
Bei einem Tupel mit Einträgen vom Datentyp real (Gleitkommazahl)
werden für
Min = Max alle Einträge des entsprechenden Wertes nur
der ersten Klasse zugeordnet.
Tuple (input_control) number-array → (real / integer)
Eingabetupel.
Min (input_control) number → (real / integer)
Minimaler Wert.
Max (input_control) number → (real / integer)
Maximaler Wert.
Restriktion: Max >= Min
NumBins (input_control) integer → (integer)
Anzahl Klassen.
Restriktion: NumBins >= 1
Histo (output_control) histogram(-array) → (integer)
Zu berechnendes Histogramm.
BinSize (output_control) real → (real)
Klassengröße.
Sind die Parameterwerte korrekt, dann liefert
tuple_histo_range den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
gray_histo,
gray_histo_abs,
gray_histo_range
Foundation