Add paper link and pipeline tag
#1
by nielsr HF Staff - opened
README.md
CHANGED
|
@@ -1,21 +1,25 @@
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
|
|
|
| 3 |
tags:
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
---
|
| 10 |
|
| 11 |
# Janus
|
| 12 |
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
|
|
|
| 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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 |
+
```
|