Skip to main content

qualia_vision/
coco_taxonomy.rs

1//! MS COCO (Common Objects in Context) 80-Category Taxonomy & Semantic Resolver.
2//!
3//! Provides zero-allocation FNV-1a IRI hashing, COCO category ID lookup, and display name
4//! resolution for all 80 MS COCO object detection classes.
5
6use crate::semantic::q_hash;
7
8/// MS COCO 80 object categories (Display Name, COCO Category ID).
9pub const COCO_80_CLASSES: &[(&str, u32)] = &[
10    ("person", 1),
11    ("bicycle", 2),
12    ("car", 3),
13    ("motorcycle", 4),
14    ("airplane", 5),
15    ("bus", 6),
16    ("train", 7),
17    ("truck", 8),
18    ("boat", 9),
19    ("traffic light", 10),
20    ("fire hydrant", 11),
21    ("stop sign", 13),
22    ("parking meter", 14),
23    ("bench", 15),
24    ("bird", 16),
25    ("cat", 17),
26    ("dog", 18),
27    ("horse", 19),
28    ("sheep", 20),
29    ("cow", 21),
30    ("elephant", 22),
31    ("bear", 23),
32    ("zebra", 24),
33    ("giraffe", 25),
34    ("backpack", 27),
35    ("umbrella", 28),
36    ("handbag", 31),
37    ("tie", 32),
38    ("suitcase", 33),
39    ("frisbee", 34),
40    ("skis", 35),
41    ("snowboard", 36),
42    ("sports ball", 37),
43    ("kite", 38),
44    ("baseball bat", 39),
45    ("baseball glove", 40),
46    ("skateboard", 41),
47    ("surfboard", 42),
48    ("tennis racket", 43),
49    ("bottle", 44),
50    ("wine glass", 46),
51    ("cup", 47),
52    ("fork", 48),
53    ("knife", 49),
54    ("spoon", 50),
55    ("bowl", 51),
56    ("banana", 52),
57    ("apple", 53),
58    ("sandwich", 54),
59    ("orange", 55),
60    ("broccoli", 56),
61    ("carrot", 57),
62    ("hot dog", 58),
63    ("pizza", 59),
64    ("donut", 60),
65    ("cake", 61),
66    ("chair", 62),
67    ("couch", 63),
68    ("potted plant", 64),
69    ("bed", 65),
70    ("dining table", 67),
71    ("toilet", 70),
72    ("tv", 72),
73    ("laptop", 73),
74    ("mouse", 74),
75    ("remote", 75),
76    ("keyboard", 76),
77    ("cell phone", 77),
78    ("microwave", 78),
79    ("oven", 79),
80    ("toaster", 80),
81    ("sink", 81),
82    ("refrigerator", 82),
83    ("book", 84),
84    ("clock", 85),
85    ("vase", 86),
86    ("scissors", 87),
87    ("teddy bear", 88),
88    ("hair drier", 89),
89    ("toothbrush", 90),
90];
91
92/// Resolve an MS COCO category display name by COCO numeric ID (1..90).
93pub fn lookup_coco_class_by_id(id: u32) -> Option<&'static str> {
94    COCO_80_CLASSES
95        .iter()
96        .find(|(_, cat_id)| *cat_id == id)
97        .map(|(name, _)| *name)
98}
99
100/// Resolve an MS COCO category display name by its deterministic FNV-1a class hash.
101pub fn lookup_coco_class_by_hash(class_hash: u64) -> Option<&'static str> {
102    COCO_80_CLASSES
103        .iter()
104        .find(|(name, _)| q_hash(name) == class_hash)
105        .map(|(name, _)| *name)
106}
107
108/// Compute the deterministic 64-bit FNV-1a class hash for a COCO display name.
109pub fn q_hash_coco_class(display_name: &str) -> u64 {
110    q_hash(display_name)
111}
112
113/// Total count of registered MS COCO object categories.
114pub fn coco_category_count() -> usize {
115    COCO_80_CLASSES.len()
116}
117
118#[cfg(test)]
119mod tests {
120    use super::*;
121
122    #[test]
123    fn test_coco_taxonomy_lookups() {
124        assert_eq!(lookup_coco_class_by_id(1), Some("person"));
125        assert_eq!(lookup_coco_class_by_id(3), Some("car"));
126        assert_eq!(lookup_coco_class_by_id(16), Some("bird"));
127        assert_eq!(lookup_coco_class_by_id(73), Some("laptop"));
128
129        let person_hash = q_hash("person");
130        assert_eq!(lookup_coco_class_by_hash(person_hash), Some("person"));
131
132        assert_eq!(coco_category_count(), 80);
133    }
134}