tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRange (Operator)

Name

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRange — Berechnen der Werteverteilung eines Tupels innerhalb eines bestimmten Wertebereichs.

Signatur

tuple_histo_range( : : Tuple, Min, Max, NumBins : Histo, BinSize)

tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRange erstellt die Werteverteilung HistoHistoHistoHistohisto des Tupels TupleTupleTupleTupletuple im Wertebereich [MinMinMinMinmin,MaxMaxMaxMaxmax]. Die Werte für MinMinMinMinmin und MaxMaxMaxMaxmax werden abgerundet falls alle Einträge des Tupels TupleTupleTupleTupletuple vom Datentyp integer (Ganzzahl) sind. Der Wertebereich wird in NumBinsNumBinsNumBinsNumBinsnumBins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizebinSize 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.

Sonderfall: Leere Eingabetupel

Falls eines oder mehrere Eingabetupel leer sind, wird eine Fehlermeldung angezeigt.

Achtung

Bei Tupeln, die nur Daten vom Typ integer (Ganzzahl) enthalten kann es in Abhängigkeit von BinSizeBinSizeBinSizeBinSizebinSize zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizebinSize > 1 werden mehrere aufeinanderfolgende Zahlen der selben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizebinSize dabei keine natürliche Zahl werden die Zahlen ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizebinSize = 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 HistoHistoHistoHistohisto bemerkbar. Gilt BinSizeBinSizeBinSizeBinSizebinSize < 1 werden je nach BinSizeBinSizeBinSizeBinSizebinSize einigen Klassen keine Zahlen zugeordnet (Für BinSizeBinSizeBinSizeBinSizebinSize = 0.5 wird beispielsweise die erste Zahl der ersten Klasse und die zweite Zahl der dritten Klasse zugeordnet). Das Histogramm HistoHistoHistoHistohisto 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 MinMinMinMinmin = MaxMaxMaxMaxmax alle Einträge des entsprechenden Wertes nur der ersten Klasse zugeordnet.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

TupleTupleTupleTupletuple (input_control) real-array → (real / integer)

Eingabetupel.

MinMinMinMinmin (input_control) real → (real / integer)

Minimaler Wert.

MaxMaxMaxMaxmax (input_control) real → (real / integer)

Maximaler Wert.

Restriktion: Max >= Min

NumBinsNumBinsNumBinsNumBinsnumBins (input_control) integer → (integer)

Anzahl Klassen.

Restriktion: NumBins >= 1

HistoHistoHistoHistohisto (output_control) histogram(-array) → (integer)

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizeBinSizebinSize (output_control) real → (real)

Klassengröße.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRange den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

tuple_mintuple_minTupleMinTupleMinTupleMin, tuple_maxtuple_maxTupleMaxTupleMaxTupleMax

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArray

Siehe auch

gray_histogray_histoGrayHistoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbs, gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRange

Modul

Foundation

Operatoren