Struct uncertainty::RelUnc

pub struct RelUnc { /* fields omitted */ }

Methods

impl RelUnc

pub fn new(val: f64, unc: f64) -> RelUnc

Create a relative uncertainty. The first parameter is the base value, and the second parameter is the relative uncertainty in the value, expressed as a decimal fraction.

Examples

use uncertainty::*;
let u: RelUnc = RelUnc::new(10.0, 0.1);
assert_eq!(u.val(), 10.0);
assert_eq!(u.unc(), 0.1);

pub fn powi(self, power: i32) -> RelUnc

Raise a relative uncertainty to an integer power.

Potential problems

Casts the i32 to an f64 in order to calculate the change in uncertainty.

Examples

let two = RelUnc::new(2.0, 0.01);
let eight = two.powi(3);
assert_abs_diff_eq!(eight.val(), 8.0);
assert_abs_diff_eq!(eight.unc(), 0.03);

pub fn powf(self, power: f64) -> RelUnc

Raise a relative uncertainty to an floating power.

Examples

let two = RelUnc::new(2.0, 0.01);
let eight = two.powf(3.0);
assert_abs_diff_eq!(eight.val(), 8.0);
assert_abs_diff_eq!(eight.unc(), 0.03);

Trait Implementations

impl Uncertainty for RelUnc

fn to_ab(self) -> AbUnc

Convert any uncertainty value into one which has an absolute uncertain value.

fn to_rel(self) -> RelUnc

Convert any uncertainty value into one which has a relative uncertain value.

fn val(&self) -> f64

Get the base value of the uncertainty.

fn unc(&self) -> f64

Get the uncertainty value; this will depend on whether the base type is a relative or absolute uncertainty.

fn min(&self) -> f64

Return the minimum possible value of the uncertainty. This is functionally the base value - the uncertainty value.

fn max(&self) -> f64

Return the maximum possible value of the uncertainty. This is functionally the base value + the uncertainty value.

fn overlap<T: Uncertainty>(&self, other: &T) -> bool

Given two uncertainty values, determine whether they overlap. This is done by comparing the minimums and maximums to see whether they intersect. Intersecting uncertainties are said to be equal or overlap.

impl From<f64> for RelUnc

fn from(float: f64) -> RelUnc

Performs the conversion.

impl From<RelUnc> for AbUnc

fn from(x: RelUnc) -> AbUnc

Performs the conversion.

impl From<AbUnc> for RelUnc

fn from(x: AbUnc) -> RelUnc

Performs the conversion.

impl Clone for RelUnc

fn clone(&self) -> RelUnc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for RelUnc

impl Display for RelUnc

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

Formats the value using the given formatter.

impl Debug for RelUnc

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

Formats the value using the given formatter.

impl Div<RelUnc> for RelUnc

type Output = RelUnc

The resulting type after applying the / operator.

fn div(self, other: RelUnc) -> Self::Output

Performs the / operation.

impl Div<f64> for RelUnc

type Output = RelUnc

The resulting type after applying the / operator.

fn div(self, other: f64) -> Self::Output

Performs the / operation.

impl Div<RelUnc> for f64

type Output = RelUnc

The resulting type after applying the / operator.

fn div(self, other: RelUnc) -> Self::Output

Performs the / operation.

impl Mul<RelUnc> for RelUnc

type Output = RelUnc

The resulting type after applying the * operator.

fn mul(self, other: RelUnc) -> Self::Output

Performs the * operation.

impl Mul<f64> for RelUnc

type Output = RelUnc

The resulting type after applying the * operator.

fn mul(self, other: f64) -> Self::Output

Performs the * operation.

impl Mul<RelUnc> for f64

type Output = RelUnc

The resulting type after applying the * operator.

fn mul(self, other: RelUnc) -> Self::Output

Performs the * operation.