Struct VecHistogram

pub struct VecHistogram<A, V> { /* private fields */ }

A Histogram that stores its values in a Vec.

See crate::ndhistogram for examples of its use.

Implementations

impl<A: Axis, V: Default + Clone> VecHistogram<A, V>

pub fn new(axes: A) -> Self

Factory method for VecHistogram. It is recommended to use the ndhistogram macro instead.

impl<A, V> VecHistogram<A, V>

pub fn par_values(&self) -> impl IndexedParallelIterator<Item = &V>

where V: Sync,

An immutable rayon parallel iterator over the histogram values.

This requires the “rayon” crate feature to be enabled.

pub fn par_values_mut(&mut self) -> impl IndexedParallelIterator<Item = &mut V>

where V: Send,

A mutable rayon parallel iterator over the histogram values.

This requires the “rayon” crate feature to be enabled.

pub fn par_iter( &self, ) -> impl IndexedParallelIterator<Item = Item<<A as Axis>::BinInterval, &V>>

where A: Axis + Sync, V: Sync, <A as Axis>::BinInterval: Send,

An immutable rayon parallel iterator over bin indices, bin interval and bin values.

This requires the “rayon” crate feature to be enabled.

pub fn par_iter_mut( &mut self, ) -> impl IndexedParallelIterator<Item = Item<<A as Axis>::BinInterval, &mut V>>

where A: Axis + Sync + Send, V: Send + Sync, <A as Axis>::BinInterval: Send,

An mutable rayon parallel iterator over bin indices, bin interval and bin values.

This requires the “rayon” crate feature to be enabled.

Trait Implementations

impl<A: Axis + PartialEq + Clone, V> Add<&V> for &VecHistogram<A, V>

where for<'a> &'a V: Add<Output = V>,

type Output = VecHistogram<A, V>

The resulting type after applying the + operator.

fn add(self, rhs: &V) -> Self::Output

Performs the + operation.

impl<A: Axis + PartialEq + Clone, V> Add<&VecHistogram<A, V>> for &VecHistogram<A, V>

where for<'a> &'a V: Add<Output = V>,

fn add(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, returning a copy, and leaving the original histograms intact.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (&hist1 + &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &3.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the + operator.

impl<A: Axis + PartialEq, V> Add<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: AddAssign<&'a V>,

fn add(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, consuming the left-hand histogram and returning a new value. As this avoids making copies of the histograms, this is the recommended method to merge histograms.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (hist1 + &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &3.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the + operator.

impl<A: Axis + PartialEq, V> AddAssign<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: AddAssign<&'a V>,

fn add_assign(&mut self, rhs: &VecHistogram<A, V>)

Combine the right-hand histogram with the left-hand histogram, mutating the left-hand histogram.

Panics

Panics if the histograms have incompatible axes. To handle this failure mode at runtime, use the non-assign version of this operation, which returns an Result.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
hist1 += &hist2;
assert_eq!(hist1.value(&0.0).unwrap(), &3.0);

impl<A: Clone, V: Clone> Clone for VecHistogram<A, V>

fn clone(&self) -> VecHistogram<A, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug, V: Debug> Debug for VecHistogram<A, V>

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

Formats the value using the given formatter.

impl<A: Default, V: Default> Default for VecHistogram<A, V>

fn default() -> VecHistogram<A, V>

Returns the “default value” for a type.

impl<'de, A, V> Deserialize<'de> for VecHistogram<A, V>

where A: Deserialize<'de>, V: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<A: Axis, V> Display for VecHistogram<A, V>

where V: Clone + Into<f64>, A::BinInterval: Display,

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

Formats the value using the given formatter.

impl<A: Axis + PartialEq + Clone, V> Div<&V> for &VecHistogram<A, V>

where for<'a> &'a V: Div<Output = V>,

type Output = VecHistogram<A, V>

The resulting type after applying the / operator.

fn div(self, rhs: &V) -> Self::Output

Performs the / operation.

impl<A: Axis + PartialEq + Clone, V> Div<&VecHistogram<A, V>> for &VecHistogram<A, V>

where for<'a> &'a V: Div<Output = V>,

fn div(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, returning a copy, and leaving the original histograms intact.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (&hist1 / &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &2.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the / operator.

impl<A: Axis + PartialEq, V> Div<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: DivAssign<&'a V>,

fn div(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, consuming the left-hand histogram and returning a new value. As this avoids making copies of the histograms, this is the recommended method to merge histograms.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (hist1 / &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &2.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the / operator.

impl<A: Axis + PartialEq, V> DivAssign<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: DivAssign<&'a V>,

fn div_assign(&mut self, rhs: &VecHistogram<A, V>)

Combine the right-hand histogram with the left-hand histogram, mutating the left-hand histogram.

Panics

Panics if the histograms have incompatible axes. To handle this failure mode at runtime, use the non-assign version of this operation, which returns an Result.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
hist1 /= &hist2;
assert_eq!(hist1.value(&0.0).unwrap(), &2.0);

impl<A: Hash, V: Hash> Hash for VecHistogram<A, V>

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<A: Axis, V> Histogram<A, V> for VecHistogram<A, V>

fn value(&self, coordinate: &A::Coordinate) -> Option<&V>

Read a bin value given a coordinate. Returns an Option as the given coordinate may not be mapped to a bin.

fn axes(&self) -> &A

The histogram Axes that map coordinates to bin numbers.

fn value_at_index(&self, index: usize) -> Option<&V>

Read a bin value given an index. Return an Option as the given index may not be valid for this histogram.

fn values<'a>(&'a self) -> Box<dyn Iterator<Item = &'a V> + 'a>

Iterator over bin values.

fn iter<'a>( &'a self, ) -> Box<dyn Iterator<Item = Item<A::BinInterval, &'a V>> + 'a>

Iterator over bin indices, bin interval and bin values.

fn value_at_index_mut(&mut self, index: usize) -> Option<&mut V>

Mutable access to a bin value at a given index.

fn values_mut(&mut self) -> Box<dyn Iterator<Item = &'_ mut V> + '_>

Mutable iterator over bin values.

fn iter_mut( &mut self, ) -> Box<dyn Iterator<Item = Item<<A as Axis>::BinInterval, &'_ mut V>> + '_>

Mutable iterator over bin indices, bin interval and bin values.

fn value_mut(&mut self, coordinate: &A::Coordinate) -> Option<&mut V>

Mutable access to a bin value at a given coordinate.

fn fill(&mut self, coordinate: &A::Coordinate)

where V: Fill,

Fill the histogram bin value at coordinate with unit weight. If the Axes do not cover that coordinate, do nothing. See Fill.

fn fill_with<D>(&mut self, coordinate: &A::Coordinate, data: D)

where V: FillWith<D>, Self: Sized,

Fill the histogram bin value at coordinate with some data. If the Axes do not cover that coordinate, do nothing. See FillWith.

fn fill_with_weighted<D, W>( &mut self, coordinate: &A::Coordinate, data: D, weight: W, )

where V: FillWithWeighted<D, W>, Self: Sized,

Fill the histogram bin value at coordinate with some data. If the Axes do not cover that coordinate, do nothing. See FillWithWeighted.

impl<'a, A: Axis, V> IntoIterator for &'a VecHistogram<A, V>

type Item = Item<<A as Axis>::BinInterval, &'a V>

The type of the elements being iterated over.

type IntoIter = Box<dyn Iterator<Item = Item<<A as Axis>::BinInterval, &'a V>> + 'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, A: Axis, V: 'a> IntoIterator for &'a mut VecHistogram<A, V>

type Item = Item<<A as Axis>::BinInterval, &'a mut V>

The type of the elements being iterated over.

type IntoIter = Box<dyn Iterator<Item = Item<<A as Axis>::BinInterval, &'a mut V>> + 'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<A: Axis + PartialEq + Clone, V> Mul<&V> for &VecHistogram<A, V>

where for<'a> &'a V: Mul<Output = V>,

type Output = VecHistogram<A, V>

The resulting type after applying the * operator.

fn mul(self, rhs: &V) -> Self::Output

Performs the * operation.

impl<A: Axis + PartialEq + Clone, V> Mul<&VecHistogram<A, V>> for &VecHistogram<A, V>

where for<'a> &'a V: Mul<Output = V>,

fn mul(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, returning a copy, and leaving the original histograms intact.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (&hist1 * &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &2.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the * operator.

impl<A: Axis + PartialEq, V> Mul<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: MulAssign<&'a V>,

fn mul(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, consuming the left-hand histogram and returning a new value. As this avoids making copies of the histograms, this is the recommended method to merge histograms.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (hist1 * &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &2.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the * operator.

impl<A: Axis + PartialEq, V> MulAssign<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: MulAssign<&'a V>,

fn mul_assign(&mut self, rhs: &VecHistogram<A, V>)

Combine the right-hand histogram with the left-hand histogram, mutating the left-hand histogram.

Panics

Panics if the histograms have incompatible axes. To handle this failure mode at runtime, use the non-assign version of this operation, which returns an Result.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
hist1 *= &hist2;
assert_eq!(hist1.value(&0.0).unwrap(), &2.0);

impl<A: Ord, V: Ord> Ord for VecHistogram<A, V>

fn cmp(&self, other: &VecHistogram<A, V>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<A: PartialEq, V: PartialEq> PartialEq for VecHistogram<A, V>

fn eq(&self, other: &VecHistogram<A, V>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<A: PartialOrd, V: PartialOrd> PartialOrd for VecHistogram<A, V>

fn partial_cmp(&self, other: &VecHistogram<A, V>) -> Option<Ordering>

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<A, V> Serialize for VecHistogram<A, V>

where A: Serialize, V: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<A: Axis + PartialEq + Clone, V> Sub<&V> for &VecHistogram<A, V>

where for<'a> &'a V: Sub<Output = V>,

type Output = VecHistogram<A, V>

The resulting type after applying the - operator.

fn sub(self, rhs: &V) -> Self::Output

Performs the - operation.

impl<A: Axis + PartialEq + Clone, V> Sub<&VecHistogram<A, V>> for &VecHistogram<A, V>

where for<'a> &'a V: Sub<Output = V>,

fn sub(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, returning a copy, and leaving the original histograms intact.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (&hist1 - &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &1.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the - operator.

impl<A: Axis + PartialEq, V> Sub<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: SubAssign<&'a V>,

fn sub(self, rhs: &VecHistogram<A, V>) -> Self::Output

Combine the right-hand histogram with the left-hand histogram, consuming the left-hand histogram and returning a new value. As this avoids making copies of the histograms, this is the recommended method to merge histograms.

If the input histograms have incompatible axes, this operation will return a crate::error::BinaryOperationError.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
let combined_hist = (hist1 - &hist2).expect("Axes are compatible");
assert_eq!(combined_hist.value(&0.0).unwrap(), &1.0);

type Output = Result<VecHistogram<A, V>, BinaryOperationError>

The resulting type after applying the - operator.

impl<A: Axis + PartialEq, V> SubAssign<&VecHistogram<A, V>> for VecHistogram<A, V>

where for<'a> V: SubAssign<&'a V>,

fn sub_assign(&mut self, rhs: &VecHistogram<A, V>)

Combine the right-hand histogram with the left-hand histogram, mutating the left-hand histogram.

Panics

Panics if the histograms have incompatible axes. To handle this failure mode at runtime, use the non-assign version of this operation, which returns an Result.

Examples

use ndhistogram::{Histogram, ndhistogram, axis::Uniform};
let mut hist1 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
let mut hist2 = ndhistogram!(Uniform::<f64>::new(10, -5.0, 5.0)?);
hist1.fill_with(&0.0, 2.0);
hist2.fill(&0.0);
hist1 -= &hist2;
assert_eq!(hist1.value(&0.0).unwrap(), &1.0);

impl<A: Eq, V: Eq> Eq for VecHistogram<A, V>

impl<A, V> StructuralPartialEq for VecHistogram<A, V>