tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRangetuple_histo_range (算子名称)

名称

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRangetuple_histo_range — Calculate the value distribution of a tuple within a certain value range.

参数签名

描述

tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRangetuple_histo_range calculates the value distribution HistoHistoHistoHistohistohisto of the TupleTupleTupleTupletupletuple within the value range [MinMinMinMinminmin,MaxMaxMaxMaxmaxmax]. The values for MinMinMinMinminmin and MaxMaxMaxMaxmaxmax are rounded down to the next integer if all entries of the TupleTupleTupleTupletupletuple are of type integer. The value range is divided into NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins bins of the same size, which is returned in BinSizeBinSizeBinSizeBinSizebinSizebin_size. If a value lies between two bins the value is assigned to the smaller bin. If the TupleTupleTupleTupletupletuple has entries of type real . If all entries are of type integer the size of a bin is computed with .

Exception: Empty input tuples

If any of the input tuples is empty, an exception is raised.

注意

If all the data of the TupleTupleTupleTupletupletuple are of type integer the value of BinSizeBinSizeBinSizeBinSizebinSizebin_size may cause the following effects: For BinSizeBinSizeBinSizeBinSizebinSizebin_size > 1 multiple consecutive numbers are assigned to the same bin. If BinSizeBinSizeBinSizeBinSizebinSizebin_size is no integer the numbers are distributed uneven among the bins, e.g., for BinSizeBinSizeBinSizeBinSizebinSizebin_size = 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 HistoHistoHistoHistohistohisto. If BinSizeBinSizeBinSizeBinSizebinSizebin_size < 1 some classes are not assigned by any number, e.g., for BinSizeBinSizeBinSizeBinSizebinSizebin_size = 0.5 the first number is assigned to the first bin and the second number is assigned to the third bin. The histogram HistoHistoHistoHistohistohisto shows some gaps, which resembles the structure of a comb.

If the TupleTupleTupleTupletupletuple has entries of type real and MinMinMinMinminmin = MaxMaxMaxMaxmaxmax, all entries of the corresponding value are assigned only to the first bin.

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 未经并行化处理。

参数表

结果

如果参数均有效，算子 tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRangetuple_histo_range 返回值 2 ( H_MSG_TRUE) . If necessary an exception is raised.

可能的前置算子

tuple_mintuple_minTupleMinTupleMinTupleMintuple_min, tuple_maxtuple_maxTupleMaxTupleMaxTupleMaxtuple_max

可能的后置算子

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array

参考其它

gray_histogray_histoGrayHistoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbsgray_histo_abs, gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRangegray_histo_range

模块

Foundation

---