Commit
·
aba89fe
1
Parent(s):
47da828
add readme
Browse files
README.md
CHANGED
|
@@ -1,3 +1,48 @@
|
|
| 1 |
---
|
| 2 |
license: mit
|
| 3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
license: mit
|
| 3 |
---
|
| 4 |
+
|
| 5 |
+
# Snuffy
|
| 6 |
+
|
| 7 |
+
Snuffy is a state-of-the-art framework for whole-slide image (WSI) classification, introduced in the
|
| 8 |
+
paper [Snuffy: Efficient Whole Slide Image Classifier](https://huggingface.co/papers/2408.08258) by Hossein Jafarinia et al. from Sharif University of
|
| 9 |
+
Technology. Tested on the TCGA Lung Cancer and CAMELYON16 datasets, it consists of two main components:
|
| 10 |
+
|
| 11 |
+
1. **Self-Supervised Continual Pre-Training with PEFT**: Uses Parameter Efficient Fine Tuning (PEFT) with AdaptFormer
|
| 12 |
+
for effective training in the pathology domain.
|
| 13 |
+
2. **Snuffy MIL-Pooling Architecture**: A novel pooling architecture designed for sparse transformers, tailored to the
|
| 14 |
+
complexity of cancer biology and tissue microenvironments.
|
| 15 |
+
|
| 16 |
+
Snuffy addresses the challenge of balancing computational power and performance in WSI classification, offering two
|
| 17 |
+
versions:
|
| 18 |
+
|
| 19 |
+
- **Efficient Snuffy**: Pre-trained on natural images and fine-tuned with PEFT on WSIs.
|
| 20 |
+
- **Exhaustive Snuffy**: Trained entirely from scratch on WSIs.
|
| 21 |
+
|
| 22 |
+
Both versions use the Snuffy MIL-pooling architecture.
|
| 23 |
+
|
| 24 |
+
## Usage
|
| 25 |
+
|
| 26 |
+
The code and documentation for Snuffy is available at: https://github.com/jafarinia/snuffy
|
| 27 |
+
This repository includes weights for the embedder, embeddings, and aggregator models as described in the paper.
|
| 28 |
+
|
| 29 |
+
Available models include:
|
| 30 |
+
|
| 31 |
+
1. **Snuffy SimCLR from scratch** (Aggregator provided here)
|
| 32 |
+
2. **Snuffy DINO from scratch** (All components provided here)
|
| 33 |
+
3. **Snuffy DINO with Adapter** (All components provided here)
|
| 34 |
+
4. **Snuffy MAE with Adapter** (All components provided here)
|
| 35 |
+
|
| 36 |
+
## BibTeX entry and citation info
|
| 37 |
+
|
| 38 |
+
```bibtex
|
| 39 |
+
@misc{jafarinia2024snuffyefficientslideimage,
|
| 40 |
+
title={Snuffy: Efficient Whole Slide Image Classifier},
|
| 41 |
+
author={Hossein Jafarinia and Alireza Alipanah and Danial Hamdi and Saeed Razavi and Nahal Mirzaie and Mohammad Hossein Rohban},
|
| 42 |
+
year={2024},
|
| 43 |
+
eprint={2408.08258},
|
| 44 |
+
archivePrefix={arXiv},
|
| 45 |
+
primaryClass={cs.CV},
|
| 46 |
+
url={https://arxiv.org/abs/2408.08258},
|
| 47 |
+
}
|
| 48 |
+
```
|