Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/szc19990412/TransMIL

TransMIL: Transformer based Correlated Multiple Instance Learning for Whole Slide Image Classification
https://github.com/szc19990412/TransMIL

Last synced: about 1 month ago
JSON representation

TransMIL: Transformer based Correlated Multiple Instance Learning for Whole Slide Image Classification

Host: GitHub
URL: https://github.com/szc19990412/TransMIL
Owner: szc19990412
Created: 2021-10-03T11:05:34.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-05-03T12:35:09.000Z (8 months ago)
Last Synced: 2024-10-22T09:49:31.913Z (2 months ago)
Language: Python
Size: 336 KB
Stars: 348
Watchers: 4
Forks: 73
Open Issues: 22
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome-pathology - TransMIL - Transformer based correlated multiple instance learning for WSI classification. (Software / Model)

README

# TransMIL: Transformer based Correlated Multiple Instance Learning for Whole Slide Image Classification [NeurIPS 2021]

TransMIL: Transformer based Correlated Multiple Instance Learning for Whole Slide Image Classification. [NeurIPS2021]

```tex
@article{shao2021transmil,
title={Transmil: Transformer based correlated multiple instance learning for whole slide image classification},
author={Shao, Zhuchen and Bian, Hao and Chen, Yang and Wang, Yifeng and Zhang, Jian and Ji, Xiangyang and others},
journal={Advances in Neural Information Processing Systems},
volume={34},
pages={2136--2147},
year={2021}
}
```

**Abstract:** With the development of computational pathology, deep learning methods for Gleason grading through whole slide images (WSIs) have excellent prospects. Since the size of WSIs is extremely large, the image label usually contains only slide-level label or limited pixel-level labels. The current mainstream approach adopts multi-instance learning to predict Gleason grades. However, some methods only considering the slide-level label ignore the limited pixel-level labels containing rich local information. Furthermore, the method of additionally considering the pixel-level labels ignores the inaccuracy of pixel-level labels. To address these problems, we propose a mixed supervision Transformer based on the multiple instance learning framework. The model utilizes both slidelevel label and instance-level labels to achieve more accurate Gleason grading at the slide level. The impact of inaccurate instance-level labels is further reduced by introducing an eﬃcient random masking strategy in the mixed supervision training process. We achieve the state-of-the-art performance on the SICAPv2 dataset, and the visual analysis shows the accurate prediction results of instance level.

![overview](docs/overview.png)

## Data Preprocess

we follow the CLAM's WSI processing solution (https://github.com/mahmoodlab/CLAM)

```bash
# WSI Segmentation and Patching
python create_patches_fp.py --source DATA_DIRECTORY --save_dir RESULTS_DIRECTORY --patch_size 256 --preset bwh_biopsy.csv --seg --patch --stitch

# Feature Extraction
CUDA_VISIBLE_DEVICES=0,1 python extract_features_fp.py --data_h5_dir DIR_TO_COORDS --data_slide_dir DATA_DIRECTORY --csv_path CSV_FILE_NAME --feat_dir FEATURES_DIRECTORY --batch_size 512 --slide_ext .svs
```

## Installation

- Linux (Tested on Ubuntu 18.04)
- NVIDIA GPU (Tested on a single Nvidia GeForce RTX 3090)
- Python (3.7.11), h5py (2.10.0), opencv-python (4.1.2.30), PyTorch (1.10.1), torchvision (0.11.2), pytorch-lightning (1.5.10).

Please refer to the following instructions.

```bash
# create and activate the conda environment
conda create -n transmil python=3.7 -y
conda activate transmil

# install pytorch
## pip install
pip install torch==1.7.1+cu110 torchvision==0.8.2+cu110 torchaudio==0.7.2 -f https://download.pytorch.org/whl/torch_stable.html
## conda install
conda install pytorch==1.7.1 torchvision==0.8.2 torchaudio==0.7.2 cudatoolkit=11.0 -c pytorch

# install related package
pip install -r requirements.txt
```

### Train

```python
python train.py --stage='train' --config='Camelyon/TransMIL.yaml' --gpus=0 --fold=0
```

### Test

```python
python train.py --stage='test' --config='Camelyon/TransMIL.yaml' --gpus=0 --fold=0
```

## Reference

- If you found our work useful in your research, please consider citing our works(s) at:

```tex

@article{shao2021transmil,
title={Transmil: Transformer based correlated multiple instance learning for whole slide image classification},
author={Shao, Zhuchen and Bian, Hao and Chen, Yang and Wang, Yifeng and Zhang, Jian and Ji, Xiangyang and others},
journal={Advances in Neural Information Processing Systems},
volume={34},
pages={2136--2147},
year={2021}
}

```