Enum Precision

pub enum Precision<T>
where
    T: Debug + Clone + PartialEq + Eq + PartialOrd,
{
    Exact(T),
    Inexact(T),
    Absent,
}

Represents a value with a degree of certainty. Precision is used to propagate information the precision of statistical values.

Variants

Exact(T)

The exact value is known

Inexact(T)

The value is not known exactly, but is likely close to this value

Absent

Nothing is known about the value

Implementations

impl<T> Precision<T>

where T: Debug + Clone + PartialEq + Eq + PartialOrd,

pub fn get_value(&self) -> Option<&T>

If we have some value (exact or inexact), it returns that value. Otherwise, it returns None.

pub fn map<U, F>(self, f: F) -> Precision<U>

where F: Fn(T) -> U, U: Debug + Clone + PartialEq + Eq + PartialOrd,

Transform the value in this Precision object, if one exists, using the given function. Preserves the exactness state.

pub fn is_exact(&self) -> Option<bool>

Returns Some(true) if we have an exact value, Some(false) if we have an inexact value, and None if there is no value.

pub fn max(&self, other: &Precision<T>) -> Precision<T>

Returns the maximum of two (possibly inexact) values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn min(&self, other: &Precision<T>) -> Precision<T>

Returns the minimum of two (possibly inexact) values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn to_inexact(self) -> Precision<T>

Demotes the precision state from exact to inexact (if present).

impl Precision<usize>

pub fn add(&self, other: &Precision<usize>) -> Precision<usize>

Calculates the sum of two (possibly inexact) usize values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn sub(&self, other: &Precision<usize>) -> Precision<usize>

Calculates the difference of two (possibly inexact) usize values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn multiply(&self, other: &Precision<usize>) -> Precision<usize>

Calculates the multiplication of two (possibly inexact) usize values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn with_estimated_selectivity(self, selectivity: f64) -> Precision<usize>

Return the estimate of applying a filter with estimated selectivity selectivity to this Precision. A selectivity of 1.0 means that all rows are selected. A selectivity of 0.5 means half the rows are selected. Will always return inexact statistics.

impl Precision<ScalarValue>

pub fn add(&self, other: &Precision<ScalarValue>) -> Precision<ScalarValue>

Calculates the sum of two (possibly inexact) ScalarValue values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn sub(&self, other: &Precision<ScalarValue>) -> Precision<ScalarValue>

Calculates the difference of two (possibly inexact) ScalarValue values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn multiply(&self, other: &Precision<ScalarValue>) -> Precision<ScalarValue>

Calculates the multiplication of two (possibly inexact) ScalarValue values, conservatively propagating exactness information. If one of the input values is Precision::Absent, the result is Absent too.

pub fn cast_to( &self, data_type: &DataType, ) -> Result<Precision<ScalarValue>, DataFusionError>

Casts the value to the given data type, propagating exactness information.

Trait Implementations

impl<T> Clone for Precision<T>

where T: Clone + Debug + PartialEq + Eq + PartialOrd,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Precision<T>

where T: Debug + Clone + PartialEq + Eq + PartialOrd,

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

Formats the value using the given formatter.

impl<T> Default for Precision<T>

where T: Debug + Clone + PartialEq + Eq + PartialOrd,

fn default() -> Precision<T>

Returns the “default value” for a type.

impl<T> Display for Precision<T>

where T: Debug + Clone + PartialEq + Eq + PartialOrd,

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

Formats the value using the given formatter.

impl From<Precision<usize>> for Precision<ScalarValue>

fn from(value: Precision<usize>) -> Precision<ScalarValue>

Converts to this type from the input type.

impl From<Precision> for Precision<ScalarValue>

fn from(s: Precision) -> Precision<ScalarValue>

Converts to this type from the input type.

impl From<Precision> for Precision<usize>

fn from(s: Precision) -> Precision<usize>

Converts to this type from the input type.

impl<T> PartialEq for Precision<T>

where T: PartialEq + Debug + Clone + Eq + PartialOrd,

fn eq(&self, other: &Precision<T>) -> 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<T> Copy for Precision<T>

where T: Copy + Debug + Clone + PartialEq + Eq + PartialOrd,

impl<T> Eq for Precision<T>

where T: Eq + Debug + Clone + PartialEq + PartialOrd,

impl<T> StructuralPartialEq for Precision<T>

where T: Debug + Clone + PartialEq + Eq + PartialOrd,