Struct ndarray_stats::histogram::strategies::Sturges

pub struct Sturges<T> { /* fields omitted */ }

R’s default strategy, only accounts for data size. Only optimal for gaussian data and underestimates number of bins for large non-gaussian datasets.

Let n be the number of observations. The number of bins is 1 plus the base 2 log of n. This estimator assumes normality of data and is too conservative for larger, non-normal datasets.

This is the default method in R’s hist method.

Notes

This strategy requires the data

• not being empty
• not being constant

Implementations

impl<T> Sturges<T> where
    T: Ord + Clone + FromPrimitive + NumOps + Zero, 

pub fn bin_width(&self) -> T

The bin width (or bin length) according to the fitted strategy.

Trait Implementations

impl<T> BinsBuildingStrategy for Sturges<T> where
    T: Ord + Clone + FromPrimitive + NumOps + Zero, 

type Elem = T

fn from_array<S>(a: &ArrayBase<S, Ix1>) -> Result<Self, BinsBuildError> where
    S: Data<Elem = Self::Elem>, 

Returns Err(BinsBuildError::Strategy) if the array is constant. Returns Err(BinsBuildError::EmptyInput) if a.len()==0. Returns Ok(Self) otherwise.

fn build(&self) -> Bins<T>

Returns a Bins instance, according to parameters inferred from observations.

fn n_bins(&self) -> usize

Returns the optimal number of bins, according to parameters inferred from observations.

impl<T: Debug> Debug for Sturges<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.