scirs2-stats 0.4.4

Statistical functions module for SciRS2 (scirs2-stats)
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

use scirs2_core::ndarray::array;
use scirs2_stats::gini_coefficient;

#[allow(dead_code)]
fn main() {
    // Example with income data - perfect equality
    let equaldata = array![100.0, 100.0, 100.0, 100.0, 100.0];
    let gini_equal = gini_coefficient(&equaldata.view()).expect("Operation failed");
    println!("Gini coefficient (perfect equality): {}", gini_equal);
    // Should be 0.0

    // Example with income data - perfect inequality (one person has everything)
    let unequaldata = array![0.0, 0.0, 0.0, 0.0, 100.0];
    let gini_unequal = gini_coefficient(&unequaldata.view()).expect("Operation failed");
    println!("Gini coefficient (perfect inequality): {}", gini_unequal);
    // Should be close to 0.8 (1 - 1/n, where n=5)

    // Example with real-world income data
    let incomedata = array![
        20000.0, 25000.0, 30000.0, 35000.0, 40000.0, 45000.0, 50000.0, 60000.0, 80000.0, 150000.0
    ];
    let gini_income = gini_coefficient(&incomedata.view()).expect("Operation failed");
    println!(
        "Gini coefficient (realistic income distribution): {}",
        gini_income
    );

    // Example with negative values (not a valid use case for Gini)
    let data_with_negative = array![10.0, -5.0, 20.0, 30.0, -10.0];
    match gini_coefficient(&data_with_negative.view()) {
        Ok(gini) => println!("Gini coefficient (with negative values): {}", gini),
        Err(e) => println!("Error: {}", e),
    }
}