Struct average::Mean

pub struct Mean { /* fields omitted */ }

Estimate the arithmetic mean of a sequence of numbers (“population”).

Example

use average::Mean;

let a: Mean = (1..6).map(f64::from).collect();
println!("The mean is {}.", a.mean());

Implementations

impl Mean

pub fn new() -> Mean

Create a new mean estimator.

pub fn is_empty(&self) -> bool

Determine whether the sample is empty.

pub fn mean(&self) -> f64

Estimate the mean of the population.

Returns 0 for an empty sample.

pub fn len(&self) -> u64

Return the sample size.

Trait Implementations

impl Clone for Mean

fn clone(&self) -> Mean

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Mean

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

Formats the value using the given formatter.

impl Default for Mean

fn default() -> Mean

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Mean

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Estimate for Mean

fn add(&mut self, sample: f64)

Add an observation sampled from the population.

fn estimate(&self) -> f64

Estimate the statistic of the population.

impl<'a> FromIterator<&'a f64> for Mean

fn from_iter<T>(iter: T) -> Mean where
    T: IntoIterator<Item = &'a f64>, 

Creates a value from an iterator.

impl FromIterator<f64> for Mean

fn from_iter<T>(iter: T) -> Mean where
    T: IntoIterator<Item = f64>, 

Creates a value from an iterator.

impl<'a> FromParallelIterator<&'a f64> for Mean

This is supported on crate feature rayon only.

fn from_par_iter<I>(par_iter: I) -> Mean where
    I: IntoParallelIterator<Item = &'a f64>,
    Self: Merge, 

Creates an instance of the collection from the parallel iterator par_iter.

impl FromParallelIterator<f64> for Mean

This is supported on crate feature rayon only.

fn from_par_iter<I>(par_iter: I) -> Mean where
    I: IntoParallelIterator<Item = f64>,
    Self: Merge, 

Creates an instance of the collection from the parallel iterator par_iter.

impl Merge for Mean

fn merge(&mut self, other: &Mean)

Merge another sample into this one.

Example

use average::{Mean, Merge};

let sequence: &[f64] = &[1., 2., 3., 4., 5., 6., 7., 8., 9.];
let (left, right) = sequence.split_at(3);
let avg_total: Mean = sequence.iter().collect();
let mut avg_left: Mean = left.iter().collect();
let avg_right: Mean = right.iter().collect();
avg_left.merge(&avg_right);
assert_eq!(avg_total.mean(), avg_left.mean());

impl Serialize for Mean

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.