Skip to main content

qualia_vision/
ade20k_taxonomy.rs

1//! MIT ADE20K 150-Category Scene Parsing Taxonomy & Semantic Resolver.
2//!
3//! Provides zero-allocation FNV-1a IRI hashing, class ID lookup (1..150),
4//! and display name resolution for all 150 ADE20K scene parsing classes.
5
6use crate::semantic::q_hash;
7
8/// MIT ADE20K 150 scene parsing classes (Display Name, Class ID 1..150).
9pub const ADE20K_150_CLASSES: &[(&str, u32)] = &[
10    ("wall", 1),
11    ("building", 2),
12    ("sky", 3),
13    ("floor", 4),
14    ("tree", 5),
15    ("ceiling", 6),
16    ("road", 7),
17    ("bed", 8),
18    ("windowpane", 9),
19    ("grass", 10),
20    ("cabinet", 11),
21    ("sidewalk", 12),
22    ("person", 13),
23    ("earth", 14),
24    ("door", 15),
25    ("table", 16),
26    ("mountain", 17),
27    ("plant", 18),
28    ("curtain", 19),
29    ("chair", 20),
30    ("car", 21),
31    ("water", 22),
32    ("painting", 23),
33    ("sofa", 24),
34    ("shelf", 25),
35    ("house", 26),
36    ("sea", 27),
37    ("mirror", 28),
38    ("rug", 29),
39    ("field", 30),
40    ("armchair", 31),
41    ("seat", 32),
42    ("fence", 33),
43    ("desk", 34),
44    ("rock", 35),
45    ("wardrobe", 36),
46    ("lamp", 37),
47    ("bathtub", 38),
48    ("railing", 39),
49    ("cushion", 40),
50    ("base", 41),
51    ("box", 42),
52    ("column", 43),
53    ("signboard", 44),
54    ("chest of drawers", 45),
55    ("counter", 46),
56    ("sand", 47),
57    ("sink", 48),
58    ("skyscraper", 49),
59    ("fireplace", 50),
60    ("refrigerator", 51),
61    ("grandstand", 52),
62    ("path", 53),
63    ("stairs", 54),
64    ("runway", 55),
65    ("case", 56),
66    ("pool table", 57),
67    ("pillow", 58),
68    ("screen door", 59),
69    ("stairway", 60),
70    ("river", 61),
71    ("bridge", 62),
72    ("bookcase", 63),
73    ("blind", 64),
74    ("coffee table", 65),
75    ("toilet", 66),
76    ("flower", 67),
77    ("book", 68),
78    ("hill", 69),
79    ("bench", 70),
80    ("countertop", 71),
81    ("stove", 72),
82    ("palm", 73),
83    ("kitchen island", 74),
84    ("computer", 75),
85    ("swivel chair", 76),
86    ("boat", 77),
87    ("bar", 78),
88    ("arcade machine", 79),
89    ("hovel", 80),
90    ("bus", 81),
91    ("towel", 82),
92    ("light", 83),
93    ("truck", 84),
94    ("tower", 85),
95    ("chandelier", 86),
96    ("awning", 87),
97    ("street lamp", 88),
98    ("booth", 89),
99    ("television receiver", 90),
100    ("airplane", 91),
101    ("dirt track", 92),
102    ("apparel", 93),
103    ("pole", 94),
104    ("land", 95),
105    ("bannister", 96),
106    ("escalator", 97),
107    ("ottoman", 98),
108    ("bottle", 99),
109    ("buffet", 100),
110    ("poster", 101),
111    ("stage", 102),
112    ("van", 103),
113    ("ship", 104),
114    ("fountain", 105),
115    ("conveyer belt", 106),
116    ("canopy", 107),
117    ("washer", 108),
118    ("plaything", 109),
119    ("swimming pool", 110),
120    ("stool", 111),
121    ("barrel", 112),
122    ("basket", 113),
123    ("waterfall", 114),
124    ("tent", 115),
125    ("bag", 116),
126    ("minibike", 117),
127    ("cradle", 118),
128    ("oven", 119),
129    ("ball", 120),
130    ("food", 121),
131    ("step", 122),
132    ("tank", 123),
133    ("trade name", 124),
134    ("microwave", 125),
135    ("pot", 126),
136    ("animal", 127),
137    ("bicycle", 128),
138    ("lake", 129),
139    ("dishwasher", 130),
140    ("screen", 131),
141    ("blanket", 132),
142    ("sculpture", 133),
143    ("hood", 134),
144    ("sconce", 135),
145    ("vase", 136),
146    ("traffic light", 137),
147    ("tray", 138),
148    ("trash can", 139),
149    ("fan", 140),
150    ("pier", 141),
151    ("crt screen", 142),
152    ("plate", 143),
153    ("monitor", 144),
154    ("bulletin board", 145),
155    ("shower", 146),
156    ("radiator", 147),
157    ("glass", 148),
158    ("clock", 149),
159    ("flag", 150),
160];
161
162/// Resolve an ADE20K scene parsing display name by numeric class ID (1..150).
163pub fn lookup_ade20k_class_by_id(id: u32) -> Option<&'static str> {
164    ADE20K_150_CLASSES
165        .iter()
166        .find(|(_, idx)| *idx == id)
167        .map(|(name, _)| *name)
168}
169
170/// Resolve an ADE20K scene parsing display name by its deterministic FNV-1a class hash.
171pub fn lookup_ade20k_class_by_hash(class_hash: u64) -> Option<&'static str> {
172    ADE20K_150_CLASSES
173        .iter()
174        .find(|(name, _)| q_hash(name) == class_hash)
175        .map(|(name, _)| *name)
176}
177
178/// Compute the deterministic 64-bit FNV-1a class hash for an ADE20K display name.
179pub fn q_hash_ade20k_class(display_name: &str) -> u64 {
180    q_hash(display_name)
181}
182
183/// Total count of registered ADE20K scene parsing categories.
184pub fn ade20k_category_count() -> usize {
185    ADE20K_150_CLASSES.len()
186}
187
188#[cfg(test)]
189mod tests {
190    use super::*;
191
192    #[test]
193    fn test_ade20k_taxonomy_lookups() {
194        assert_eq!(lookup_ade20k_class_by_id(1), Some("wall"));
195        assert_eq!(lookup_ade20k_class_by_id(2), Some("building"));
196        assert_eq!(lookup_ade20k_class_by_id(3), Some("sky"));
197        assert_eq!(lookup_ade20k_class_by_id(150), Some("flag"));
198
199        let tree_hash = q_hash("tree");
200        assert_eq!(lookup_ade20k_class_by_hash(tree_hash), Some("tree"));
201
202        assert_eq!(ade20k_category_count(), 150);
203    }
204}