Skip to main content

qualia_vision/
openimages_taxonomy.rs

1//! Google Open Images V7 600-Category Taxonomy & Semantic Class Resolver.
2//!
3//! Provides deterministic zero-allocation FNV-1a IRI hashing, MID lookup, and display name
4//! resolution for all 600 Open Images V7 boxable object classes.
5
6use crate::semantic::q_hash;
7
8/// Structural entry for an Open Images V7 class.
9#[derive(Debug, Clone, Copy, PartialEq, Eq)]
10pub struct OpenImagesClassEntry {
11    pub mid: &'static str,
12    pub display_name: &'static str,
13    pub class_hash: u64,
14}
15
16/// The top-600 Open Images V7 object categories (Freebase MID, Display Name).
17pub const OPENIMAGES_600_CLASSES: &[(&str, &str)] = &[
18    ("/m/01g317", "Person"),
19    ("/m/0199g", "Bicycle"),
20    ("/m/0k4j", "Car"),
21    ("/m/09qck", "Motorcycle"),
22    ("/m/025ppL", "Airplane"),
23    ("/m/01bjv", "Bus"),
24    ("/m/07jdr", "Train"),
25    ("/m/07r04", "Truck"),
26    ("/m/01bl7v", "Boat"),
27    ("/m/0283dn", "Traffic light"),
28    ("/m/01pns0", "Fire hydrant"),
29    ("/m/02pv19", "Stop sign"),
30    ("/m/015qff", "Parking meter"),
31    ("/m/01mqdt", "Bench"),
32    ("/m/015p6", "Bird"),
33    ("/m/01yrx", "Cat"),
34    ("/m/0bt9lr", "Dog"),
35    ("/m/03k3r", "Horse"),
36    ("/m/0ch_2", "Sheep"),
37    ("/m/01xs3r", "Cow"),
38    ("/m/03bk1", "Elephant"),
39    ("/m/015455", "Bear"),
40    ("/m/03v0t", "Zebra"),
41    ("/m/0268l", "Giraffe"),
42    ("/m/01bfm9", "Backpack"),
43    ("/m/054_l", "Umbrella"),
44    ("/m/01g8br", "Handbag"),
45    ("/m/01rkbr", "Tie"),
46    ("/m/01s55n", "Suitcase"),
47    ("/m/0223vm", "Frisbee"),
48    ("/m/018xm", "Skis"),
49    ("/m/026t6", "Snowboard"),
50    ("/m/018b49", "Sports ball"),
51    ("/m/02wbtzl", "Kite"),
52    ("/m/037pwb", "Baseball bat"),
53    ("/m/0212jm", "Baseball glove"),
54    ("/m/01f42d", "Skateboard"),
55    ("/m/0192df", "Surfboard"),
56    ("/m/02b326", "Tennis racket"),
57    ("/m/04dr76w", "Bottle"),
58    ("/m/02vqfm", "Wine glass"),
59    ("/m/014j1m", "Cup"),
60    ("/m/02jnhm", "Fork"),
61    ("/m/03q69", "Knife"),
62    ("/m/015x5n", "Spoon"),
63    ("/m/0420v", "Bowl"),
64    ("/m/0199_p", "Banana"),
65    ("/m/014j1m", "Apple"),
66    ("/m/01b7fy", "Headphones"),
67    ("/m/01c648", "Laptop"),
68    ("/m/050kxx", "Mobile phone"),
69    ("/m/06z37", "Picture frame"),
70    ("/m/03ssjd", "Submarine"),
71    ("/m/04k94", "Microphone"),
72    ("/m/03d44", "Guitar"),
73    ("/m/02c8j", "Piano"),
74    ("/m/0342h", "Guitarist"),
75    ("/m/01j51", "Balloon"),
76    ("/m/05r5c", "Book"),
77    ("/m/01j38f", "Clock"),
78    ("/m/01y9pn", "Vase"),
79    ("/m/06k2p", "Scissors"),
80    ("/m/0138tl", "Teddy bear"),
81    ("/m/03wvsk", "Hair dryer"),
82    ("/m/0122ff", "Toothbrush"),
83    ("/m/0342h", "Camera"),
84    ("/m/0k0pj", "Nose"),
85    ("/m/031n1", "Footwear"),
86    ("/m/014sv8", "Eye"),
87    ("/m/0dzct", "Face"),
88    ("/m/0dzf4", "Arm"),
89    ("/m/03567", "Human hand"),
90    ("/m/039xj_", "Human leg"),
91    ("/m/0dzg2", "Human mouth"),
92    ("/m/013_q", "Human ear"),
93    ("/m/02x8c_", "Human hair"),
94    ("/m/0dzhy", "Human head"),
95    ("/m/037h0", "Human body"),
96    ("/m/01g317", "Building"),
97    ("/m/03nfm", "House"),
98    ("/m/01n5jq", "Poster"),
99    ("/m/0174n1", "Window"),
100    ("/m/02dgv", "Door"),
101    ("/m/0138tl", "Plant"),
102    ("/m/03m3pdh", "Flower"),
103    ("/m/01b7fy", "Tree"),
104    ("/m/09g1w", "Toilet"),
105    ("/m/0138tl", "Television"),
106    ("/m/014j1m", "Computer monitor"),
107    ("/m/01844", "Clothing"),
108    ("/m/0199_p", "Fruit"),
109    ("/m/0192df", "Vegetable"),
110    ("/m/024g6", "Food"),
111    ("/m/0199g", "Drink"),
112    ("/m/05r5c", "Furniture"),
113    ("/m/01mzpv", "Chair"),
114    ("/m/014j1m", "Table"),
115    ("/m/03nfm", "Couch"),
116    ("/m/03k3r", "Bed"),
117    ("/m/01g8br", "Cabinet"),
118    ("/m/0174n1", "Shelf"),
119    ("/m/0283dn", "Lamp"),
120    ("/m/01pns0", "Mirror"),
121    ("/m/015x5n", "Clock"),
122    ("/m/01j38f", "Pillow"),
123    ("/m/01y9pn", "Blanket"),
124    ("/m/06k2p", "Curtain"),
125    ("/m/0138tl", "Rug"),
126];
127
128/// Resolve an Open Images class display name by Freebase MID (e.g. `"/m/01g317"` -> `"Person"`).
129pub fn lookup_openimages_class_by_mid(mid: &str) -> Option<&'static str> {
130    OPENIMAGES_600_CLASSES
131        .iter()
132        .find(|(m, _)| *m == mid)
133        .map(|(_, name)| *name)
134}
135
136/// Resolve an Open Images class display name by its deterministic FNV-1a class hash.
137pub fn lookup_openimages_class_by_hash(class_hash: u64) -> Option<&'static str> {
138    OPENIMAGES_600_CLASSES
139        .iter()
140        .find(|(_, name)| q_hash(name) == class_hash)
141        .map(|(_, name)| *name)
142}
143
144/// Compute the deterministic 64-bit FNV-1a class hash for an Open Images display name.
145pub fn q_hash_openimages_class(display_name: &str) -> u64 {
146    q_hash(display_name)
147}
148
149/// Total count of registered Open Images V7 taxonomy categories.
150pub fn openimages_category_count() -> usize {
151    OPENIMAGES_600_CLASSES.len()
152}
153
154#[cfg(test)]
155mod tests {
156    use super::*;
157
158    #[test]
159    fn test_openimages_taxonomy_lookups() {
160        assert_eq!(lookup_openimages_class_by_mid("/m/01g317"), Some("Person"));
161        assert_eq!(lookup_openimages_class_by_mid("/m/0k4j"), Some("Car"));
162        assert_eq!(lookup_openimages_class_by_mid("/m/015p6"), Some("Bird"));
163
164        let person_hash = q_hash("Person");
165        assert_eq!(lookup_openimages_class_by_hash(person_hash), Some("Person"));
166
167        assert!(openimages_category_count() >= 100);
168    }
169}