Skip to main content

qualia_vision/
pascal_voc_taxonomy.rs

1//! PASCAL VOC (Visual Object Classes) 20-Category Taxonomy & Semantic Resolver.
2//!
3//! Provides zero-allocation FNV-1a IRI hashing, class index mapping (0..19),
4//! and display name resolution for all 20 PASCAL VOC object classes.
5
6use crate::semantic::q_hash;
7
8/// PASCAL VOC 20 object classes (Display Name, Class Index 0..19).
9pub const PASCAL_VOC_20_CLASSES: &[(&str, u32)] = &[
10    ("aeroplane", 0),
11    ("bicycle", 1),
12    ("bird", 2),
13    ("boat", 3),
14    ("bottle", 4),
15    ("bus", 5),
16    ("car", 6),
17    ("cat", 7),
18    ("chair", 8),
19    ("cow", 9),
20    ("diningtable", 10),
21    ("dog", 11),
22    ("horse", 12),
23    ("motorbike", 13),
24    ("person", 14),
25    ("pottedplant", 15),
26    ("sheep", 16),
27    ("sofa", 17),
28    ("train", 18),
29    ("tvmonitor", 19),
30];
31
32/// Resolve a PASCAL VOC class display name by numeric class index (0..19).
33pub fn lookup_pascal_voc_class_by_id(id: u32) -> Option<&'static str> {
34    PASCAL_VOC_20_CLASSES
35        .iter()
36        .find(|(_, idx)| *idx == id)
37        .map(|(name, _)| *name)
38}
39
40/// Resolve a PASCAL VOC class display name by its deterministic FNV-1a class hash.
41pub fn lookup_pascal_voc_class_by_hash(class_hash: u64) -> Option<&'static str> {
42    PASCAL_VOC_20_CLASSES
43        .iter()
44        .find(|(name, _)| q_hash(name) == class_hash)
45        .map(|(name, _)| *name)
46}
47
48/// Compute the deterministic 64-bit FNV-1a class hash for a PASCAL VOC display name.
49pub fn q_hash_pascal_voc_class(display_name: &str) -> u64 {
50    q_hash(display_name)
51}
52
53/// Total count of registered PASCAL VOC object categories.
54pub fn pascal_voc_category_count() -> usize {
55    PASCAL_VOC_20_CLASSES.len()
56}
57
58#[cfg(test)]
59mod tests {
60    use super::*;
61
62    #[test]
63    fn test_pascal_voc_taxonomy_lookups() {
64        assert_eq!(lookup_pascal_voc_class_by_id(0), Some("aeroplane"));
65        assert_eq!(lookup_pascal_voc_class_by_id(6), Some("car"));
66        assert_eq!(lookup_pascal_voc_class_by_id(14), Some("person"));
67
68        let dog_hash = q_hash("dog");
69        assert_eq!(lookup_pascal_voc_class_by_hash(dog_hash), Some("dog"));
70
71        assert_eq!(pascal_voc_category_count(), 20);
72    }
73}