OccamChainsaw commited on
Commit
aba89fe
·
1 Parent(s): 47da828

add readme

Browse files
Files changed (1) hide show
  1. README.md +45 -0
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
+ ```