11.2.1.3. astroML.density_estimation.knuth_bin_width¶

astroML.density_estimation.knuth_bin_width(data, return_bins=False, disp=True)[source]¶

Deprecated since version 0.4: The knuth_bin_width function is deprecated and may be removed in a future version. Use astropy.stats.knuth_bin_width instead.

Return the optimal histogram bin width using Knuth’s rule [Rc52d530680fe-1]

Parameters

dataarray-like, ndim=1

observed (one-dimensional) data

return_binsbool (optional): if True, then return the bin edges

Returns

dxfloat

optimal bin width. Bins are measured starting at the first data point.

binsndarray: bin edges: returned if return_bins is True

Notes

The optimal number of bins is the value M which maximizes the function

$F(M|x,I) = n\log(M) + \log\Gamma(\frac{M}{2}) - M\log\Gamma(\frac{1}{2}) - \log\Gamma(\frac{2n+M}{2}) + \sum_{k=1}^M \log\Gamma(n_k + \frac{1}{2})$

where $\Gamma$ is the Gamma function, $n$ is the number of data points, $n_k$ is the number of measurements in bin $k$ .

11.2.1.2. astroML.density_estimation.bayesian_blocks 11.2.1.4. astroML.density_estimation.scotts_bin_width