freedman_bin_width¶
-
astropy.stats.
freedman_bin_width
(data, return_bins=False)[source] [edit on github]¶ Return the optimal histogram bin width using the Freedman-Diaconis rule
The Freedman-Diaconis rule is a normal reference rule like Scott’s rule, but uses rank-based statistics for results which are more robust to deviations from a normal distribution.
Parameters: data : array-like, ndim=1
observed (one-dimensional) data
return_bins : bool (optional)
if True, then return the bin edges
Returns: width : float
optimal bin width using the Freedman-Diaconis rule
bins : ndarray
bin edges: returned if
return_bins
is TrueSee also
knuth_bin_width
,scott_bin_width
,bayesian_blocks
,histogram
Notes
The optimal bin width is
where
is the
percent quartile of the data, and
is the number of data points [R89].
References
[R89] (1, 2) D. Freedman & P. Diaconis (1981) “On the histogram as a density estimator: L2 theory”. Probability Theory and Related Fields 57 (4): 453-476