Enum Bins 

#[non_exhaustive]
pub enum Bins<T> {
    Count(usize),
    Edges(Vec<T>),
    Sturges,
    Sqrt,
    Rice,
    Scott,
    Fd,
    Doane,
    Auto,
}

How to specify bins for histogram functions.

In addition to an explicit Count or Edges, the rule-based variants mirror numpy.histogram(bins=...) strings: 'sturges', 'sqrt', 'rice', 'scott', 'fd', 'doane', and 'auto' (max of 'sturges' and 'fd', numpy’s default). Added for #472.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Count(usize)

Number of equal-width bins.

Edges(Vec<T>)

Explicit bin edges (must be sorted, length = nbins + 1).

Sturges

Sturges’ rule: ceil(log2(n)) + 1. Conservative default for near-Gaussian data; underestimates for heavy-tailed inputs.

Sqrt

Square-root rule: ceil(sqrt(n)). Used by Excel.

Rice

Rice’s rule: ceil(2 * n^(1/3)).

Scott

Scott’s rule: bin width = 3.5 * std / n^(1/3). Optimal for Gaussian data.

Fd

Freedman–Diaconis rule: bin width = 2 * IQR / n^(1/3). Robust to outliers.

Doane

Doane’s rule (Sturges + skewness correction).

Auto

numpy default — max(sturges, fd). Falls back to Sturges if FD is degenerate (IQR == 0).

Trait Implementations

impl<T: Clone> Clone for Bins<T>

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

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Bins<T>

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

Formats the value using the given formatter.