matten 0.29.0

A family-car multidimensional array (tensor) library for small numerical trials / PoCs.
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

//! Visual readiness summary for a dynamic tensor.
//!
//! Run: cargo run --example dynamic_09_visual_readiness_summary --features dynamic
//!
//! The report stays local to this example. It shows what is present, what is
//! missing, what is numeric under the default policy, and what an explicit
//! conversion policy changes.

#[cfg(not(feature = "dynamic"))]
fn main() {
    println!("Requires --features dynamic");
}

#[cfg(feature = "dynamic")]
fn main() -> Result<(), Box<dyn std::error::Error>> {
    use matten::{Element, NumericPolicy, Tensor};

    let t = Tensor::from_elements(
        vec![
            Element::Float(1.0),
            Element::text("2.5"),
            Element::None,
            Element::Int(4),
            Element::text("6.0"),
            Element::Float(8.0),
        ],
        &[2, 3],
    );

    println!("== Dynamic values ==");
    println!("shape            {:?}", t.shape());
    println!("values           {:?}", t.to_elements());
    println!("summary          {}", t.schema_summary());
    assert!(t.is_dynamic());
    assert_eq!(t.shape(), &[2, 3]);
    assert_eq!(t.count_none(), 1);

    println!();
    println!("== Readiness masks ==");
    let none_mask = t.none_mask();
    let numeric_mask = t.numeric_mask();
    println!("none_mask        {:?}", none_mask.as_slice());
    println!("numeric_mask     {:?}", numeric_mask.as_slice());
    println!("numeric_ready    {}", t.is_numeric_convertible());
    assert_eq!(none_mask.as_slice(), &[0.0, 0.0, 1.0, 0.0, 0.0, 0.0]);
    assert_eq!(numeric_mask.as_slice(), &[1.0, 0.0, 0.0, 1.0, 0.0, 1.0]);
    assert!(!t.is_numeric_convertible());

    println!();
    println!("== Conversion ==");
    match t.try_numeric() {
        Err(e) => println!("strict          Err: {e}"),
        Ok(_) => panic!("strict conversion should reject Text and None"),
    }

    let converted = t.try_numeric_with(NumericPolicy::default().none_as(0.0).allow_text_parse())?;
    println!("explicit policy none_as(0.0) + allow_text_parse()");
    println!("converted shape {:?}", converted.shape());
    println!("converted values {:?}", converted.as_slice());
    assert!(!converted.is_dynamic());
    assert_eq!(converted.shape(), &[2, 3]);
    assert_eq!(converted.as_slice(), &[1.0, 2.5, 0.0, 4.0, 6.0, 8.0]);

    println!();
    println!("dynamic_09_visual_readiness_summary: OK");
    Ok(())
}