radiate-utils 1.3.0

A Rust library for genetic algorithms and artificial evolution.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use crate::{Float, Statistic};
#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};

#[derive(Clone, PartialEq)]
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
pub struct Distribution<F: Float> {
    statistic: Statistic<F>,
    values: Vec<F>,
}

impl<F: Float> Distribution<F> {
    pub fn with_capacity(capacity: usize) -> Self {
        Distribution {
            statistic: Statistic::default(),
            values: Vec::with_capacity(capacity),
        }
    }

    #[inline(always)]
    pub fn add(&mut self, value: F) {
        if self.values.capacity() == self.values.len() {
            panic!(
                "Distribution capacity exceeded: {}. Consider increasing the capacity or using a different data structure.",
                self.values.capacity()
            );
        }

        self.statistic.add(value);
        self.values.push(value);
    }

    pub fn count(&self) -> usize {
        self.values.len()
    }

    pub fn min(&self) -> F {
        self.statistic.min()
    }

    pub fn max(&self) -> F {
        self.statistic.max()
    }

    pub fn mean(&self) -> F {
        self.statistic.mean()
    }

    pub fn sum(&self) -> F {
        self.statistic.sum()
    }

    pub fn variance(&self) -> Option<F> {
        self.statistic.variance()
    }

    pub fn std_dev(&self) -> Option<F> {
        self.statistic.std_dev()
    }

    pub fn skewness(&self) -> Option<F> {
        self.statistic.skewness()
    }

    pub fn kurtosis(&self) -> Option<F> {
        self.statistic.kurtosis()
    }

    pub fn clear(&mut self) {
        self.statistic.clear();
        self.values.clear();
    }
}

impl<F> Extend<F> for Distribution<F>
where
    F: Float,
{
    fn extend<T: IntoIterator<Item = F>>(&mut self, iter: T) {
        self.clear();
        self.values.extend(iter);

        for &value in &self.values {
            self.statistic.add(value);
        }
    }
}

impl From<&[f32]> for Distribution<f32> {
    fn from(value: &[f32]) -> Self {
        let mut result = Distribution::with_capacity(value.len());
        for &v in value {
            result.add(v);
        }

        result
    }
}

impl From<Vec<f32>> for Distribution<f32> {
    fn from(value: Vec<f32>) -> Self {
        let mut result = Distribution::with_capacity(value.len());
        for v in value {
            result.add(v);
        }
        result
    }
}

impl From<&Vec<usize>> for Distribution<f32> {
    fn from(value: &Vec<usize>) -> Self {
        let mut dist = Distribution::with_capacity(value.len());
        for v in value.iter().map(|&v| v as f32) {
            dist.add(v);
        }

        dist
    }
}