Struct ndhistogram::value::Mean

pub struct Mean<T = f64, O = f64, C = u32> { /* private fields */ }

This ndhistogram bin value computes the mean of the data samples provided when filling.

Mean has 3 type parameters:

• the type that is being averaged,
• the type of the output when calculating the mean and its uncertainty,
• the type that counts the number of fills.

This allows, for example, integers to be used when filling or counting, but a floating point type to compute the mean. In most cases, you will only need to specify the first type as sensible defaults are set for the second two type parameters.

Example

use ndhistogram::{ndhistogram, Histogram, axis::Uniform, value::Mean};

// create a histogram and fill it with some values
let mut hist = ndhistogram!(Uniform::new(10, 0.0, 10.0); Mean<i32>);
hist.fill_with(&0.0, 1);
hist.fill_with(&0.0, 2);
hist.fill_with(&0.0, 3);

let mean = hist.value(&0.0);
assert_eq!(mean.unwrap().get(), 2.0); // should be the mean of [1,2,3]

Implementations

impl<C, T, O> Mean<T, O, C>where O: From<T> + From<C> + NumOps + Signed + Copy, C: Copy, T: Copy,

pub fn new<I>(values: I) -> Selfwhere I: IntoIterator<Item = T>, Self: FillWith<T> + Default,

Factory method to create a Mean from a set of values.

Usually this will not be used as a Histogram will be responsible for creating and filling values.

pub fn get(&self) -> O

Get the current value of the mean.

pub fn mean(&self) -> <O as Div>::Output

Get the current value of the mean.

pub fn num_samples(&self) -> C

Get the number of times the mean value has been filled.

pub fn variance_of_samples(&self) -> O

Compute the variance of the samples.

pub fn standard_deviation_of_samples(&self) -> Owhere O: Float,

The square root of the variance of the samples.

pub fn variance_of_mean(&self) -> O

The square of the standard error of the mean.

pub fn standard_error_of_mean(&self) -> Owhere O: Float,

Compute the standard error of the mean.

Trait Implementations

impl<T: Clone, O: Clone, C: Clone> Clone for Mean<T, O, C>

fn clone(&self) -> Mean<T, O, C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug, O: Debug, C: Debug> Debug for Mean<T, O, C>

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

Formats the value using the given formatter.

impl<T: Default, O: Default, C: Default> Default for Mean<T, O, C>

fn default() -> Mean<T, O, C>

Returns the “default value” for a type.

impl<'de, T, O, C> Deserialize<'de> for Mean<T, O, C>where T: Deserialize<'de>, C: Deserialize<'de>,

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

Deserialize this value from the given Serde deserializer.

impl<T, C, O> FillWith<T> for Mean<T, O, C>where T: Copy + AddAssign + Mul<Output = T>, C: AddAssign + One,

fn fill_with(&mut self, data: T)

Fill this value with some data. For a simple number type means adding the weight.

impl<T: Hash, O: Hash, C: Hash> Hash for Mean<T, O, C>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Ord, O: Ord, C: Ord> Ord for Mean<T, O, C>

fn cmp(&self, other: &Mean<T, O, C>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl<T: PartialEq, O: PartialEq, C: PartialEq> PartialEq<Mean<T, O, C>> for Mean<T, O, C>

fn eq(&self, other: &Mean<T, O, C>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialOrd, O: PartialOrd, C: PartialOrd> PartialOrd<Mean<T, O, C>> for Mean<T, O, C>

fn partial_cmp(&self, other: &Mean<T, O, C>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T, O, C> Serialize for Mean<T, O, C>where T: Serialize, C: Serialize,

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

Serialize this value into the given Serde serializer.

impl<T: Copy, O: Copy, C: Copy> Copy for Mean<T, O, C>

impl<T: Eq, O: Eq, C: Eq> Eq for Mean<T, O, C>

impl<T, O, C> StructuralEq for Mean<T, O, C>

impl<T, O, C> StructuralPartialEq for Mean<T, O, C>