tuple_histo_range — Calculate the value distribution of a tuple within a certain value range.
gray_histo_range calculates the value distribution Histo of the Tuple within the value range [Min,Max]. The values for Min and Max are rounded down to the next integer if all entries of the Tuple are of type integer. The value range is devided into NumBins bins of the same size, which is returned in BinSize. If a value lies between two bins the value is assigned to the smaller bin. If the Tuple has entries of type real BinSize = (Max - Min) / NumBins . If all entries are of type integer the size of a bin is computed with BinSize = (Max - Min + 1) / NumBins.
If all the data of the Tuple are of type integer the value of BinSize may cause the following effects: For BinSize > 1 multiple consecutive numbers are assigned to the same bin. If BinSize is no integer the numbers are distributed uneven among the bins, e.g., for BinSize = 1.5 the first and second number are assigned to the first bin, the third number is assigned to the second bin, and the fourth and fifth number are assigned to the third bin. This becomes noticeable in several peeks in the histogram Histo. If BinSize < 1 some classes are not assigned by any number, e.g., for BinSize = 0.5 the first number is assigned to the first bin and the second number is assigned to the third bin. The histogram Histo shows some gaps, which resembles the structure of a comb.
If the Tuple has entries of type real and Min = Max, all entries of the corresponding value are assigned only to the first bin.
Restriction: Max >= Min
Number of bins.
Restriction: NumBins >= 1
Histogram to be calculated.
If the parameters are valid, the operator tuple_histo_range returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.
gray_histo, gray_histo_abs, gray_histo_range