numpy.histogram_bin_edges
numpy.histogram_bin_edges(a, bins=10, range=None, weights=None) [source]
仅计算histogram函数使用的bin边缘的函数。参数 :a :array_like
输入数据。直方图是在展平的数组上计算的。
bins :int 或 sequence of scalars 或 str, 可选
如果bins是一个int,
则它定义给定范围内的等宽 bins数(默认为10个)。
如果bin是序列,则它将定义bin边缘(包括最右边),
从而允许非均匀的bin宽度。
如果bins是下面列表中的字符串,
histogram_bin_edges将使用选择的方法来计算最佳bin宽度,
从而根据落下的数据计算bin的数量
(有关估计量的更多信息,请参见“Notes”)。
在要求的范围内。虽然箱宽对于该范围内的实际数据而言是最佳的,
但bins 数将被计算为填充整个范围,包括空白部分。
为了实现可视化,建议使用 ‘auto’ 选项。
自动箱大小选择不支持加权数据。‘auto’'sturges'和' fd'估计量的最大值。提供良好的整体性能。‘fd’ (Freedman Diaconis Estimator)考虑数据可变性和数据大小的健壮(对离群值有弹性)估计器。‘doane’Sturges ' estimator的改进版本,能更好地处理非正规数据集。‘scott’考虑到数据可变性和数据大小的不太稳健的估计。‘stone’基于leave-one-out cross-validation的综合平方误差估计的估计量。
可以看作是斯科特规则的概括。‘rice’估计器不考虑可变性,只考虑数据的大小。
通常高估所需bins的数量。‘sturges’R的默认方法,只考虑数据大小。只对高斯数据最优,
对大的非高斯数据集低估bins数。‘sqrt’平方根(数据大小)估计器,用于Excel和其他程序的速度和简单。
range :(float, float), 可选
bins的上下范围。如果未提供,则范围只是(a.min(),a.max())。
超出范围的值将被忽略。范围的第一个元素必须小于或等于第二个。
范围也会影响自动bin计算。
虽然根据范围内的实际数据计算出箱宽是最佳的,
但箱数将填充整个范围,包括不包含数据的部分。
weights :array_like, 可选
一组与a形状相同的weights。
每个中的每个值仅将其相关权重分配给bin计数(而不是1)。
目前,任何bin估算器均未使用此功能,但将来可能会使用。
返回值 :bin_edges :array of dtype float
要传递到histogram中的边缘
Notes
估计箱的最佳数量的方法在文献中已经建立,并且受到R为直方图可视化提供的选择的启发。请注意,使bins数与比例成正比是渐近最优的,这就是为什么它出现在大多数估计器中的原因。这些都是简单的插件方法,可为bins数量提供良好的起点。在下面的公式中,是binwidth和bin的数量。使用数据的ptp将所有计算bin计数的估计器重转成为bin宽度。最终的bin计数是从np.round(np.ceil(range / h))获得的。
‘auto’ (maximum of the ‘sturges’ and ‘fd’ estimators)
为了得到一个好的价值而做出的妥协。对于小型数据集,Sturges值通常会被选择,而大型数据集通常会默认为FD。避免FD和Sturges分别对小数据集和大数据集过于保守的行为。切换点通常在
。
‘fd’ (Freedman Diaconis Estimator)
binwidth与四分位范围(IQR)成正比,与a的立方根成反比。对于小数据集可能过于保守,但对于大数据集非常好。IQR对异常值非常稳健。
‘scott’
binwidth与数据的标准偏差成正比,与x.size的立方根成反比。对于小数据集可能过于保守,但对于大数据集非常好。标准差对离群值不是很稳健。在没有异常值的情况下,值非常类似于Freedman-Diaconis估计量。
‘rice’
bins的数量只与a.size的立方根成正比。它倾向于高估bins的数量,而不考虑数据的可变性。
‘sturges’
bins的数量以a.size的2 log为底。该估计量假设数据正态性,对于较大的非正态数据集过于保守。这是R的hist方法中的默认方法。
‘doane’
斯特奇斯公式的改进版本,对非正常数据集产生更好的估计。这个估计器试图解释数据的歪斜。
‘sqrt’
最简单最快的估计值。只考虑数据大小。
例子>>> arr = np.array([0, 0, 0, 1, 2, 3, 3, 4, 5])
>>> np.histogram_bin_edges(arr, bins='auto', range=(0, 1))
array([0. , 0.25, 0.5 , 0.75, 1. ])
>>> np.histogram_bin_edges(arr, bins=2)
array([0. , 2.5, 5. ])
为了与直方图保持一致,预先计算的bin数组将通过未修改的传递:>>> np.histogram_bin_edges(arr, [1, 2])
array([1, 2])
此功能允许计算一组bin,并在多个直方图中重复使用:>>> shared_bins = np.histogram_bin_edges(arr, bins='auto')
>>> shared_bins
array([0., 1., 2., 3., 4., 5.])>>> group_id = np.array([0, 1, 1, 0, 1, 1, 0, 1, 1])
>>> hist_0, _ = np.histogram(arr[group_id == 0], bins=shared_bins)
>>> hist_1, _ = np.histogram(arr[group_id == 1], bins=shared_bins)>>> hist_0; hist_1
array([1, 1, 0, 1, 0])
array([2, 0, 1, 1, 2])
与为每个直方图使用单独的bin相比,这提供了更容易比较的结果:>>> hist_0, bins_0 = np.histogram(arr[group_id == 0], bins='auto')
>>> hist_1, bins_1 = np.histogram(arr[group_id == 1], bins='auto')
>>> hist_0; hist_1
array([1, 1, 1])
array([2, 1, 1, 2])
>>> bins_0; bins_1
array([0., 1., 2., 3.])
array([0. , 1.25, 2.5 , 3.75, 5. ])