Struct stats_ci::mean::Geometric

pub struct Geometric<F: Float> { /* private fields */ }

Represents the state of the computation of the geometric mean. This is a simple implementation that accumulates information about the samples, such as sum and sum of squares. It is implemented as a wrapper around Arithmetic to compute the arithmetic mean of the logarithms of the samples.

It is best used through the StatisticsOps trait.

Implementations

impl<F: Float> Geometric<F>

pub fn new() -> Self

Create a new empty state

Example

let mut stats = mean::Geometric::new();
stats.append(10.)?;
assert_eq!(stats.sample_count(), 1);
assert_abs_diff_eq!(stats.sample_mean(), 10., epsilon = 1e-10);

Trait Implementations

impl<F: Float> Add<Geometric<F>> for Geometric<F>

type Output = Geometric<F>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<F: Clone + Float> Clone for Geometric<F>

fn clone(&self) -> Geometric<F>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F: Debug + Float> Debug for Geometric<F>

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

Formats the value using the given formatter.

impl<F: Float> Default for Geometric<F>

fn default() -> Self

Returns the “default value” for a type.

impl<F: Float> StatisticsOps<F> for Geometric<F>

fn sample_mean(&self) -> F

Geometric mean of the sample

fn sample_sem(&self) -> F

Standard error of the geometric mean

Computed as: \( G \frac{s_{\log x_i}}{\sqrt{n-1}} \) where \( G \) is the geometric mean of the sample; \( s_{\log x_i} \) is the estimate of the standard deviation of the logarithms of the samples; and \( n-1 \) is the degree of freedom of the sample data.

Reference

• Nilan Noris. “The standard errors of the geometric and harmonic means and their application to index numbers.” Ann. Math. Statist. 11(4): 445-448 (December, 1940). DOI: 10.1214/aoms/1177731830 JSTOR

fn ci_mean(&self, confidence: Confidence) -> CIResult<Interval<F>>

Confidence interval for the geometric mean

fn append(&mut self, x: F) -> CIResult<()>

Append a new sample to the data

fn sample_count(&self) -> usize

Number of samples

fn from_iter<I: IntoIterator<Item = F>>(data: I) -> CIResult<Self>

Create a new state and “populates” it with data from an iterator

fn extend<I: IntoIterator<Item = F>>(&mut self, data: I) -> CIResult<()>

Extend the data with additional sample data.

impl<F: Copy + Float> Copy for Geometric<F>