Add paper link and pipeline tag

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +26 -32
README.md CHANGED
@@ -1,21 +1,25 @@
1
  ---
2
  license: apache-2.0
 
3
  tags:
4
- - medical-imaging
5
- - ct-scan
6
- - multi-label-classification
7
- - radiology
8
- - disease-detection
9
  ---
10
 
11
  # Janus
12
 
13
- Multi-label abdominal disease classification from 3-D CT scans.
14
- DINOv3 backbone with four ablation variants: GAP, Masked Attention,
15
- Scalar Fusion, and Gated Fusion.
 
16
 
17
  ## Ablation variants
18
 
 
 
19
  | Variant | Folder | Macro AUROC | Needs seg masks | Needs radiomics |
20
  |---|---|---|---|---|
21
  | GAP (baseline) | `gap/` | 0.8488 | β€” | β€” |
@@ -23,8 +27,7 @@ Scalar Fusion, and Gated Fusion.
23
  | Scalar Fusion | `scalar-fusion/` | 0.8332 | βœ“ | βœ“ |
24
  | **Gated Fusion** | **`gated-fusion/`** | **0.8811** | βœ“ | βœ“ |
25
 
26
- Each folder contains `model.safetensors` and `config.json` (labels, image size,
27
- input requirements, best macro AUROC).
28
 
29
  ## Quick-start β€” GAP variant (self-contained)
30
 
@@ -35,23 +38,11 @@ pip install torch transformers safetensors nibabel scipy huggingface_hub
35
  python inference.py ct.nii.gz --variant gap --top 10
36
  ```
37
 
38
- Example output:
39
- ```
40
- Disease Prob
41
- ──────────────────────────────────────────────────
42
- Atherosclerosis 0.821 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ
43
- Renal Cyst 0.714 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ
44
- Hepatic Steatosis 0.431 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ
45
- ...
46
- ```
47
-
48
  ## Full pipeline (masked-attn / gated-fusion / scalar-fusion)
49
 
50
- These variants require organ segmentation masks (and radiomics features for
51
- fusion models). Use the full Janus preprocessing pipeline:
52
 
53
- **Source code:** https://github.com/lavsendahal/janus
54
- *(Repository is currently private β€” request access if needed.)*
55
 
56
  ```bash
57
  git clone https://github.com/lavsendahal/janus
@@ -68,14 +59,17 @@ python -m janus.inference --variant gated-fusion --ct ct.nii.gz
68
 
69
  ## Diseases (30 labels)
70
 
71
- Hepatomegaly, Splenomegaly, Cardiomegaly, Prostatomegaly, Hepatic Steatosis,
72
- Osteopenia, Gallstones, AAA, Aortic Valve Calcification, Coronary Calcification,
73
- Atherosclerosis, Thrombosis, Bowel Obstruction, Appendicitis, Hiatal Hernia,
74
- Submucosal Edema, Free Air, Biliary Ductal Dilation, Absent Gallbladder,
75
- Pancreatic Atrophy, Hydronephrosis, Renal Cyst, Renal Hypodensities,
76
- Pleural Effusion, Atelectasis, Ascites, Anasarca, Metastatic Disease,
77
- Lymphadenopathy, Fracture.
78
 
79
  ## Citation
80
 
81
- If you use this model, please cite the Janus paper (forthcoming).
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  license: apache-2.0
3
+ pipeline_tag: image-classification
4
  tags:
5
+ - medical-imaging
6
+ - ct-scan
7
+ - multi-label-classification
8
+ - radiology
9
+ - disease-detection
10
  ---
11
 
12
  # Janus
13
 
14
+ Official model weights for **JANUS**, a physiology-guided dual-stream architecture for robust CT triage. JANUS conditions visual embeddings on macro-radiomic priors via Anatomically Guided Gating to improve discrimination and reliability under distribution shift.
15
+
16
+ - **Paper:** [JANUS: Anatomy-Conditioned Gating for Robust CT Triage Under Distribution Shift](https://huggingface.co/papers/2605.13813)
17
+ - **Repository:** [https://github.com/lavsendahal/janus](https://github.com/lavsendahal/janus)
18
 
19
  ## Ablation variants
20
 
21
+ The repository contains weights for different model variants explored in the paper:
22
+
23
  | Variant | Folder | Macro AUROC | Needs seg masks | Needs radiomics |
24
  |---|---|---|---|---|
25
  | GAP (baseline) | `gap/` | 0.8488 | β€” | β€” |
 
27
  | Scalar Fusion | `scalar-fusion/` | 0.8332 | βœ“ | βœ“ |
28
  | **Gated Fusion** | **`gated-fusion/`** | **0.8811** | βœ“ | βœ“ |
29
 
30
+ Each folder contains `model.safetensors` and `config.json` (labels, image size, input requirements, best macro AUROC).
 
31
 
32
  ## Quick-start β€” GAP variant (self-contained)
33
 
 
38
  python inference.py ct.nii.gz --variant gap --top 10
39
  ```
40
 
 
 
 
 
 
 
 
 
 
 
41
  ## Full pipeline (masked-attn / gated-fusion / scalar-fusion)
42
 
43
+ These variants require organ segmentation masks (and radiomics features for fusion models). Use the full Janus preprocessing pipeline:
 
44
 
45
+ **Source code:** [https://github.com/lavsendahal/janus](https://github.com/lavsendahal/janus)
 
46
 
47
  ```bash
48
  git clone https://github.com/lavsendahal/janus
 
59
 
60
  ## Diseases (30 labels)
61
 
62
+ Hepatomegaly, Splenomegaly, Cardiomegaly, Prostatomegaly, Hepatic Steatosis, Osteopenia, Gallstones, AAA, Aortic Valve Calcification, Coronary Calcification, Atherosclerosis, Thrombosis, Bowel Obstruction, Appendicitis, Hiatal Hernia, Submucosal Edema, Free Air, Biliary Ductal Dilation, Absent Gallbladder, Pancreatic Atrophy, Hydronephrosis, Renal Cyst, Renal Hypodensities, Pleural Effusion, Atelectasis, Ascites, Anasarca, Metastatic Disease, Lymphadenopathy, Fracture.
 
 
 
 
 
 
63
 
64
  ## Citation
65
 
66
+ If you use this model, please cite the following:
67
+
68
+ ```bibtex
69
+ @article{janus2026,
70
+ title={JANUS: Anatomy-Conditioned Gating for Robust CT Triage Under Distribution Shift},
71
+ author={Dahal, Lavsen and others},
72
+ journal={arXiv preprint arXiv:2605.13813},
73
+ year={2026}
74
+ }
75
+ ```