[][src]Trait rustc_test::stats::Stats

pub trait Stats {
    pub fn sum(&self) -> f64;
pub fn min(&self) -> f64;
pub fn max(&self) -> f64;
pub fn mean(&self) -> f64;
pub fn median(&self) -> f64;
pub fn var(&self) -> f64;
pub fn std_dev(&self) -> f64;
pub fn std_dev_pct(&self) -> f64;
pub fn median_abs_dev(&self) -> f64;
pub fn median_abs_dev_pct(&self) -> f64;
pub fn percentile(&self, pct: f64) -> f64;
pub fn quartiles(&self) -> (f64, f64, f64);
pub fn iqr(&self) -> f64; }

Trait that provides simple descriptive statistics on a univariate set of numeric samples.

Required methods

pub fn sum(&self) -> f64[src]

Sum of the samples.

Note: this method sacrifices performance at the altar of accuracy Depends on IEEE-754 arithmetic guarantees. See proof of correctness at: ["Adaptive Precision Floating-Point Arithmetic and Fast Robust Geometric Predicates"] (http://www.cs.cmu.edu/~quake-papers/robust-arithmetic.ps)

pub fn min(&self) -> f64[src]

Minimum value of the samples.

pub fn max(&self) -> f64[src]

Maximum value of the samples.

pub fn mean(&self) -> f64[src]

Arithmetic mean (average) of the samples: sum divided by sample-count.

See: https://en.wikipedia.org/wiki/Arithmetic_mean

pub fn median(&self) -> f64[src]

Median of the samples: value separating the lower half of the samples from the higher half. Equal to self.percentile(50.0).

See: https://en.wikipedia.org/wiki/Median

pub fn var(&self) -> f64[src]

Variance of the samples: bias-corrected mean of the squares of the differences of each sample from the sample mean. Note that this calculates the sample variance rather than the population variance, which is assumed to be unknown. It therefore corrects the (n-1)/n bias that would appear if we calculated a population variance, by dividing by (n-1) rather than n.

See: https://en.wikipedia.org/wiki/Variance

pub fn std_dev(&self) -> f64[src]

Standard deviation: the square root of the sample variance.

Note: this is not a robust statistic for non-normal distributions. Prefer the median_abs_dev for unknown distributions.

See: https://en.wikipedia.org/wiki/Standard_deviation

pub fn std_dev_pct(&self) -> f64[src]

Standard deviation as a percent of the mean value. See std_dev and mean.

Note: this is not a robust statistic for non-normal distributions. Prefer the median_abs_dev_pct for unknown distributions.

pub fn median_abs_dev(&self) -> f64[src]

Scaled median of the absolute deviations of each sample from the sample median. This is a robust (distribution-agnostic) estimator of sample variability. Use this in preference to std_dev if you cannot assume your sample is normally distributed. Note that this is scaled by the constant 1.4826 to allow its use as a consistent estimator for the standard deviation.

See: http://en.wikipedia.org/wiki/Median_absolute_deviation

pub fn median_abs_dev_pct(&self) -> f64[src]

Median absolute deviation as a percent of the median. See median_abs_dev and median.

pub fn percentile(&self, pct: f64) -> f64[src]

Percentile: the value below which pct percent of the values in self fall. For example, percentile(95.0) will return the value v such that 95% of the samples s in self satisfy s <= v.

Calculated by linear interpolation between closest ranks.

See: http://en.wikipedia.org/wiki/Percentile

pub fn quartiles(&self) -> (f64, f64, f64)[src]

Quartiles of the sample: three values that divide the sample into four equal groups, each with 1/4 of the data. The middle value is the median. See median and percentile. This function may calculate the 3 quartiles more efficiently than 3 calls to percentile, but is otherwise equivalent.

See also: https://en.wikipedia.org/wiki/Quartile

pub fn iqr(&self) -> f64[src]

Inter-quartile range: the difference between the 25th percentile (1st quartile) and the 75th percentile (3rd quartile). See quartiles.

See also: https://en.wikipedia.org/wiki/Interquartile_range

Loading content...

Implementations on Foreign Types

impl Stats for [f64][src]

Loading content...

Implementors

Loading content...