#[must_use]
pub fn mean(values: &[f32]) -> Option<f32> {
if values.is_empty() {
return None;
}
let mut sum = 0.0_f32;
for value in values {
if !value.is_finite() {
return None;
}
sum += *value;
}
Some(sum / values.len() as f32)
}
#[must_use]
pub fn stddev(values: &[f32]) -> Option<f32> {
let mu = mean(values)?;
if values.len() < 2 {
return Some(0.0);
}
let mut acc = 0.0_f32;
for value in values {
let d = *value - mu;
acc += d * d;
}
let var = acc / values.len() as f32;
Some(sqrt_approx(var))
}
#[must_use]
pub fn z_score(value: f32, mu: f32, sigma: f32) -> Option<f32> {
if !value.is_finite() || !mu.is_finite() || !sigma.is_finite() {
return None;
}
if sigma <= 1e-6 {
return Some(if (value - mu).abs() <= 1e-6 {
0.0
} else {
f32::INFINITY
});
}
Some((value - mu).abs() / sigma)
}
pub fn median(values: &[f32], scratch: &mut [f32]) -> Option<f32> {
if values.is_empty() || scratch.len() < values.len() {
return None;
}
scratch[..values.len()].copy_from_slice(values);
let slice = &mut scratch[..values.len()];
for i in 1..slice.len() {
let mut j = i;
while j > 0
&& slice[j]
.partial_cmp(&slice[j - 1])
.unwrap_or(core::cmp::Ordering::Equal)
.is_lt()
{
slice.swap(j, j - 1);
j -= 1;
}
}
let mid = slice.len() / 2;
if slice.len().is_multiple_of(2) {
Some((slice[mid - 1] + slice[mid]) * 0.5)
} else {
Some(slice[mid])
}
}
#[must_use]
pub fn hour_of_day_ns(time_ns: i64) -> u8 {
let day_ns = 86_400_i64.saturating_mul(1_000_000_000);
let tod = time_ns.rem_euclid(day_ns);
let hour = tod / 3_600_000_000_000;
u8::try_from(hour.clamp(0, 23)).unwrap_or(0)
}
#[must_use]
pub fn day_of_week_ns(time_ns: i64) -> u8 {
let day = time_ns.div_euclid(86_400_i64.saturating_mul(1_000_000_000));
u8::try_from(day.rem_euclid(7)).unwrap_or(0)
}
fn sqrt_approx(value: f32) -> f32 {
if value <= 0.0 || !value.is_finite() {
return 0.0;
}
let mut y = value;
for _ in 0..8 {
y = 0.5 * (y + value / y);
}
y
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn mean_std_z_and_median() {
let values = [1.0_f32, 2.0, 3.0, 4.0, 5.0];
assert!((mean(&values).unwrap() - 3.0).abs() < 1e-5);
assert!(stddev(&values).unwrap() > 1.0);
assert!((z_score(3.0, 3.0, 1.0).unwrap()).abs() < 1e-5);
let mut scratch = [0.0_f32; 8];
assert!((median(&values, &mut scratch).unwrap() - 3.0).abs() < 1e-5);
}
}