matcat 0.1.0

Material Categories & Variants — human-friendly layer on top of utomid chemistry.
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

# MatCat

**Material Categories & Variants** — a human-friendly layer on top of [`utomid`](https://crates.io/crates/utomid-rs).

---

## 🚀 Features

- Group vague material categories (Metal, Plastic, Wood, …).
- Map specific variants (Steel, PVC, Oak) to chemical definitions (`utomid`-based).
- Handle uncertainty with confidence scores (probabilistic picks).
- Human-friendly input, simulation-ready output.

---

## 📦 Installation

```bash
cargo add matcat
```

---

## 🔍 Example

```rust
use matcat::{Category, Variant, Material, MaterialConfidence};
use matcat::variants::example_variants;

fn main() {
    let variants = example_variants();

    let mat = Material::new(
        Category::Metal,
        vec![
            MaterialConfidence { variant: variants[0].clone(), confidence: 0.8 },
        ],
    );

    println!("Category: {}", mat.category.name());
    println!("Most likely: {:?}", mat.most_likely().unwrap().name);
}
```

---

## 📄 License

MIT © JD Plumbing