1use serde::{Deserialize, Serialize};
15
16#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
19pub enum Karyotype {
20 Xy,
22 Xx,
24}
25
26#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
28pub enum AnatomyModel {
29 Male,
30 Female,
31}
32
33impl Karyotype {
34 pub fn anatomy_model(self) -> AnatomyModel {
36 match self {
37 Karyotype::Xy => AnatomyModel::Male,
38 Karyotype::Xx => AnatomyModel::Female,
39 }
40 }
41
42 pub fn as_str(self) -> &'static str {
44 match self {
45 Karyotype::Xy => "XY",
46 Karyotype::Xx => "XX",
47 }
48 }
49
50 pub fn parse(s: &str) -> Option<Self> {
54 match s.trim().to_ascii_uppercase().as_str() {
55 "XY" => Some(Karyotype::Xy),
56 "XX" => Some(Karyotype::Xx),
57 _ => None,
58 }
59 }
60}
61
62impl AnatomyModel {
63 pub fn asset_set(self) -> &'static str {
65 match self {
66 AnatomyModel::Male => "VH_Male",
67 AnatomyModel::Female => "VH_Female",
68 }
69 }
70
71 pub fn file_infix(self) -> &'static str {
74 match self {
75 AnatomyModel::Male => "m",
76 AnatomyModel::Female => "f",
77 }
78 }
79
80 pub fn as_str(self) -> &'static str {
82 match self {
83 AnatomyModel::Male => "male",
84 AnatomyModel::Female => "female",
85 }
86 }
87
88 pub fn parse(s: &str) -> Option<Self> {
90 match s.trim().to_ascii_lowercase().as_str() {
91 "male" => Some(AnatomyModel::Male),
92 "female" => Some(AnatomyModel::Female),
93 _ => None,
94 }
95 }
96}
97
98pub fn normalize_organ_key(raw: &str) -> String {
102 let mut s = raw.trim().to_ascii_lowercase();
103 for ext in [".glb", ".gltf", ".obj", ".stl"] {
104 if let Some(rest) = s.strip_suffix(ext) {
105 s = rest.to_string();
106 break;
107 }
108 }
109 let has_3d = s.starts_with("3d-");
113 if let Some(pos) = s.find("-m-").or_else(|| s.find("-f-")) {
114 if has_3d || pos <= 8 {
115 s = s[pos + 3..].to_string();
116 }
117 }
118 for lat in ["-left", "-right", "-l", "-r"] {
119 if let Some(rest) = s.strip_suffix(lat) {
120 s = rest.to_string();
121 break;
122 }
123 }
124 s
125}
126
127static ORGAN_SYSTEMS: &[(&str, &str)] = &[
133 ("blood-vasculature", "circulatory"),
135 ("heart", "circulatory"),
136 ("vasculature", "circulatory"),
137 ("lung", "respiratory"),
139 ("larynx", "respiratory"),
140 ("trachea", "respiratory"),
141 ("bronchus", "respiratory"),
142 ("main-bronchus", "respiratory"),
143 ("respiratory-system", "respiratory"),
144 ("liver", "digestive"),
146 ("stomach", "digestive"),
147 ("mouth", "digestive"),
148 ("small-intestine", "digestive"),
149 ("large-intestine", "digestive"),
150 ("colon", "digestive"),
151 ("pancreas", "digestive"),
152 ("gallbladder", "digestive"),
153 ("esophagus", "digestive"),
154 ("brain", "nervous"),
156 ("spinal-cord", "nervous"),
157 ("nerve", "nervous"),
158 ("eye", "sensory"),
160 ("ear", "sensory"),
161 ("cochlea", "sensory"),
162 ("inner-ear", "vestibular"),
164 ("semicircular-canal", "vestibular"),
165 ("vestibule", "vestibular"),
166 ("kidney", "urinary"),
168 ("bladder", "urinary"),
169 ("urinary-bladder", "urinary"),
170 ("ureter", "urinary"),
171 ("urethra", "urinary"),
172 ("renal-pyramid", "urinary"),
173 ("spleen", "immune_lymphatic"),
175 ("thymus", "immune_lymphatic"),
176 ("lymph-node", "immune_lymphatic"),
177 ("tonsil", "immune_lymphatic"),
178 ("lymphatic-system", "immune_lymphatic"),
179 ("skin", "integumentary"),
181 ("mammary-gland", "integumentary"),
182 ("bone", "skeletal"),
184 ("skeleton", "skeletal"),
185 ("rib", "skeletal"),
186 ("pelvis", "skeletal"),
187 ("muscle", "muscular"),
189 ("diaphragm", "muscular"), ("thyroid-gland", "endocrine"),
192 ("thyroid", "endocrine"),
193 ("adrenal-gland", "endocrine"),
194 ("pituitary-gland", "endocrine"),
195 ("salivary-gland", "exocrine"),
198 ("parotid-gland", "exocrine"),
199 ("submandibular-gland", "exocrine"),
200 ("sublingual-gland", "exocrine"),
201 ("lacrimal-gland", "exocrine"),
202 ("sweat-gland", "exocrine"),
203 ("sebaceous-gland", "exocrine"),
204 ("prostate", "reproductive"),
206 ("testis", "reproductive"),
207 ("uterus", "reproductive"),
208 ("ovary", "reproductive"),
209 ("fallopian-tube", "reproductive"),
210 ("vagina", "reproductive"),
211 ("placenta", "reproductive"),
212 ("placenta-full-term", "reproductive"),
213];
214
215pub fn body_system_for_organ(organ: &str) -> Option<&'static str> {
220 let key = normalize_organ_key(organ);
221 ORGAN_SYSTEMS
222 .iter()
223 .find(|(o, _)| *o == key)
224 .map(|(_, sys)| *sys)
225}
226
227static ORGAN_SECONDARY_SYSTEMS: &[(&str, &str)] = &[
233 ("pancreas", "endocrine"), ("pancreas", "exocrine"), ("liver", "endocrine"), ("liver", "exocrine"), ("kidney", "endocrine"), ("ovary", "endocrine"), ("testis", "endocrine"), ("bone", "immune_lymphatic"), ("skin", "sensory"), ("skin", "exocrine"), ("mammary-gland", "exocrine"), ("diaphragm", "respiratory"), ];
246
247pub fn primary_organ_system_pairs() -> &'static [(&'static str, &'static str)] {
254 ORGAN_SYSTEMS
255}
256
257pub fn secondary_organ_system_pairs() -> &'static [(&'static str, &'static str)] {
259 ORGAN_SECONDARY_SYSTEMS
260}
261
262pub fn system_memberships_for_organ(organ: &str) -> Vec<(&'static str, bool)> {
264 let key = normalize_organ_key(organ);
265 let mut out: Vec<(&'static str, bool)> = Vec::new();
266 if let Some((_, sys)) = ORGAN_SYSTEMS.iter().find(|(o, _)| *o == key) {
267 out.push((*sys, true));
268 }
269 for (o, sys) in ORGAN_SECONDARY_SYSTEMS {
270 if *o == key && !out.iter().any(|(s, _)| s == sys) {
271 out.push((*sys, false));
272 }
273 }
274 out
275}
276
277#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
279pub enum SystemRepresentation {
280 DiscreteOrgans,
282 DistributedOverlay,
285}
286
287pub fn system_representation(system_id: &str) -> SystemRepresentation {
294 match system_id {
295 "ecs" | "ens" | "glymphatic" => SystemRepresentation::DistributedOverlay,
296 _ => SystemRepresentation::DiscreteOrgans,
297 }
298}
299
300pub fn overlay_host_systems(system_id: &str) -> &'static [&'static str] {
307 match system_id {
308 "ens" => &["digestive"],
309 "glymphatic" => &["nervous"],
310 "ecs" => &[], _ => &[],
312 }
313}
314
315#[cfg(test)]
316mod tests {
317 use super::*;
318 use crate::anatomy::systems::body_system;
321
322 #[test]
323 fn karyotype_selects_reference_model() {
324 assert_eq!(Karyotype::Xy.anatomy_model(), AnatomyModel::Male);
325 assert_eq!(Karyotype::Xx.anatomy_model(), AnatomyModel::Female);
326 assert_eq!(Karyotype::Xy.anatomy_model().asset_set(), "VH_Male");
327 assert_eq!(Karyotype::Xx.anatomy_model().asset_set(), "VH_Female");
328 assert_eq!(AnatomyModel::Male.file_infix(), "m");
329 assert_eq!(AnatomyModel::Female.file_infix(), "f");
330 }
331
332 #[test]
333 fn karyotype_parse_is_closed_and_case_insensitive() {
334 assert_eq!(Karyotype::parse("xy"), Some(Karyotype::Xy));
335 assert_eq!(Karyotype::parse(" XX "), Some(Karyotype::Xx));
336 assert_eq!(Karyotype::parse("XXY"), None);
338 assert_eq!(Karyotype::parse(""), None);
339 assert_eq!(
341 Karyotype::parse(Karyotype::Xy.as_str()),
342 Some(Karyotype::Xy)
343 );
344 }
345
346 #[test]
347 fn organ_keys_normalize_across_asset_and_lateral_forms() {
348 assert_eq!(normalize_organ_key("3d-vh-m-eye-l.glb"), "eye");
349 assert_eq!(normalize_organ_key("3d-vh-f-eye-r.glb"), "eye");
350 assert_eq!(normalize_organ_key("eye-left"), "eye");
351 assert_eq!(
352 normalize_organ_key("blood-vasculature"),
353 "blood-vasculature"
354 );
355 assert_eq!(normalize_organ_key(" VH-M-Lung "), "lung");
356 assert_eq!(normalize_organ_key("3d-allen-m-brain.glb"), "brain");
358 assert_eq!(
359 normalize_organ_key("3d-sbu-m-large-intestine.glb"),
360 "large-intestine"
361 );
362 assert_eq!(normalize_organ_key("3d-nih-f-lymph-node.glb"), "lymph-node");
363 assert_eq!(
364 normalize_organ_key("3d-vh-m-main-bronchus.glb"),
365 "main-bronchus"
366 );
367 }
368
369 #[test]
370 fn organs_map_to_systems_and_unknowns_are_none() {
371 assert_eq!(
372 body_system_for_organ("3d-vh-m-lung.glb"),
373 Some("respiratory")
374 );
375 assert_eq!(
376 body_system_for_organ("blood-vasculature"),
377 Some("circulatory")
378 );
379 assert_eq!(body_system_for_organ("eye-left"), Some("sensory"));
380 assert_eq!(body_system_for_organ("kidney-r"), Some("urinary"));
381 assert_eq!(body_system_for_organ("prostate"), Some("reproductive"));
383 assert_eq!(body_system_for_organ("uterus"), Some("reproductive"));
384 assert_eq!(
386 body_system_for_organ("3d-allen-m-brain.glb"),
387 Some("nervous")
388 );
389 assert_eq!(
390 body_system_for_organ("3d-nih-m-lymph-node.glb"),
391 Some("immune_lymphatic")
392 );
393 assert_eq!(
394 body_system_for_organ("3d-vh-m-main-bronchus.glb"),
395 Some("respiratory")
396 );
397 assert_eq!(
398 body_system_for_organ("3d-vh-m-mouth.glb"),
399 Some("digestive")
400 );
401 assert_eq!(
402 body_system_for_organ("3d-vh-m-pelvis.glb"),
403 Some("skeletal")
404 );
405 assert_eq!(
406 body_system_for_organ("3d-vh-m-urinary-bladder.glb"),
407 Some("urinary")
408 );
409 assert_eq!(body_system_for_organ("3d-vh-m-flux-capacitor.glb"), None);
411 }
412
413 #[test]
414 fn organs_participate_in_multiple_systems() {
415 use crate::anatomy::systems::body_system;
416 let m = system_memberships_for_organ("3d-vh-m-pancreas.glb");
418 assert_eq!(m[0], ("digestive", true), "primary comes first");
419 let ids: Vec<&str> = m.iter().map(|(s, _)| *s).collect();
420 assert!(
421 ids.contains(&"endocrine") && ids.contains(&"exocrine"),
422 "pancreas multi-system: {ids:?}"
423 );
424 assert_eq!(body_system_for_organ("pancreas"), Some("digestive"));
426 let skin: Vec<&str> = system_memberships_for_organ("skin")
428 .iter()
429 .map(|(s, _)| *s)
430 .collect();
431 assert!(
432 skin.contains(&"integumentary")
433 && skin.contains(&"sensory")
434 && skin.contains(&"exocrine"),
435 "skin memberships: {skin:?}"
436 );
437 assert_eq!(
439 system_memberships_for_organ("heart"),
440 vec![("circulatory", true)]
441 );
442 let dia: Vec<&str> = system_memberships_for_organ("diaphragm")
444 .iter()
445 .map(|(s, _)| *s)
446 .collect();
447 assert_eq!(dia, vec!["muscular", "respiratory"]);
448 for (organ, sys) in ORGAN_SECONDARY_SYSTEMS {
450 assert!(
451 body_system(sys).is_some(),
452 "organ {organ} secondary → unknown system {sys}"
453 );
454 }
455 assert!(system_memberships_for_organ("flux-capacitor").is_empty());
457 }
458
459 #[test]
460 fn every_mapped_system_id_is_a_real_body_system() {
461 for (organ, sys) in ORGAN_SYSTEMS {
463 assert!(
464 body_system(sys).is_some(),
465 "organ {organ} maps to unknown system id {sys}"
466 );
467 }
468 }
469
470 #[test]
471 fn every_one_of_the_17_systems_is_accounted_for() {
472 use crate::anatomy::systems::BODY_SYSTEMS;
476 assert_eq!(BODY_SYSTEMS.len(), 17);
477 for s in BODY_SYSTEMS {
478 let has_organ = ORGAN_SYSTEMS.iter().any(|(_, sys)| *sys == s.id);
479 match system_representation(s.id) {
480 SystemRepresentation::DiscreteOrgans => assert!(
481 has_organ,
482 "discrete-organ system {} has no organ in the paint map",
483 s.id
484 ),
485 SystemRepresentation::DistributedOverlay => assert!(
486 !has_organ,
487 "distributed system {} should not carry a standalone organ",
488 s.id
489 ),
490 }
491 }
492 }
493
494 #[test]
495 fn only_ecs_ens_glymphatic_are_distributed_overlays() {
496 for &distributed in &["ecs", "ens", "glymphatic"] {
497 assert_eq!(
498 system_representation(distributed),
499 SystemRepresentation::DistributedOverlay
500 );
501 }
502 assert_eq!(body_system_for_organ("inner-ear"), Some("vestibular"));
504 assert_eq!(body_system_for_organ("salivary-gland"), Some("exocrine"));
505 for &discrete in &["circulatory", "vestibular", "exocrine", "reproductive"] {
506 assert_eq!(
507 system_representation(discrete),
508 SystemRepresentation::DiscreteOrgans
509 );
510 }
511 }
512
513 #[test]
514 fn distributed_overlays_carry_anatomical_host_hints() {
515 assert_eq!(overlay_host_systems("ens"), &["digestive"]);
517 assert_eq!(overlay_host_systems("glymphatic"), &["nervous"]);
518 assert_eq!(overlay_host_systems("ecs"), &[] as &[&str]);
519 for &distributed in &["ens", "glymphatic", "ecs"] {
521 for host in overlay_host_systems(distributed) {
522 assert!(
523 body_system(host).is_some(),
524 "{distributed} host {host} unknown"
525 );
526 assert_eq!(
527 system_representation(host),
528 SystemRepresentation::DiscreteOrgans
529 );
530 }
531 }
532 }
533}