Struct ndhistogram::axis::CategoryNoFlow

pub struct CategoryNoFlow<T>where
    T: Eq + Hash,{ /* private fields */ }

An axis to represent a finite set of discrete values or categories without an overflow bin.

Similar to Category, however, no overflow bin is included.

Example

use ndhistogram::axis::{Axis, CategoryNoFlow, SingleValueBinInterval};
let colors = CategoryNoFlow::new(vec!["red", "blue", "pink", "yellow", "black"]);
assert_eq!(colors.index(&"red"), Some(0));
assert_eq!(colors.index(&"green"), None);
assert_eq!(colors.bin(1), Some(SingleValueBinInterval::new("blue")));
assert_eq!(colors.bin(5), None);

Implementations

impl<T: Value> CategoryNoFlow<T>

pub fn new<I: IntoIterator<Item = T>>(values: I) -> Self

Factory method to create a category axis without an overflow bin.

Takes a set of values that represent each category. All other values will not be included in this axis.

Trait Implementations

impl<T: Value> Axis for CategoryNoFlow<T>

type Coordinate = T

The type representing a location on this axis.

type BinInterval = SingleValueBinInterval<T>

The type of an interval representing the set of Coordinates that correspond to a histogram bin

fn index(&self, coordinate: &Self::Coordinate) -> Option<usize>

Map from coordinate to bin number. Returns an option as not all valid coordinates are necessarily contained within a bin.

fn num_bins(&self) -> usize

The number of bins in this axis, including underflow and overflow.

fn bin(&self, index: usize) -> Option<Self::BinInterval>

Map from bin number to axis to the interval covering the range of coordinates that this bin contains. Returns an option in case an index >= Axis::num_bins is given.

fn indices(&self) -> Box<dyn Iterator<Item = usize>>

An iterator over bin numbers

fn iter(&self) -> Box<dyn Iterator<Item = (usize, Self::BinInterval)> + '_>

An iterator over bin numbers and bin intervals

fn bins(&self) -> Box<dyn Iterator<Item = Self::BinInterval> + '_>

An iterator over bin intervals.

fn num_dim(&self) -> usize

The number of dimensions that this object corresponds to. For most Axis types this will simply be 1. However, Axes (i.e. a set of Axis) also implement Axis and should return the number of Axis that it contains.

impl<T> Clone for CategoryNoFlow<T>where T: Eq + Hash + Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for CategoryNoFlow<T>where T: Eq + Hash + Debug,

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

Formats the value using the given formatter.

impl<T> Default for CategoryNoFlow<T>where T: Eq + Hash + Default,

fn default() -> CategoryNoFlow<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for CategoryNoFlow<T>where T: Eq + Hash + 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: Display + Value> Display for CategoryNoFlow<T>

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

Formats the value using the given formatter.

impl<'a, T: Value> IntoIterator for &'a CategoryNoFlow<T>

type Item = (usize, <Category<T> as Axis>::BinInterval)

The type of the elements being iterated over.

type IntoIter = Box<dyn Iterator<Item = <&'a CategoryNoFlow<T> as IntoIterator>::Item> + 'a, Global>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T> PartialEq<CategoryNoFlow<T>> for CategoryNoFlow<T>where T: Eq + Hash + PartialEq,

fn eq(&self, other: &CategoryNoFlow<T>) -> 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> Serialize for CategoryNoFlow<T>where T: Eq + Hash + 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> Eq for CategoryNoFlow<T>where T: Eq + Hash + Eq,

impl<T> StructuralEq for CategoryNoFlow<T>where T: Eq + Hash,

impl<T> StructuralPartialEq for CategoryNoFlow<T>where T: Eq + Hash,