Pytorch Medical Segmentation

Read Chinese Introduction：Here！

Recent Updates

• 2021.1.8 The train and test codes are released.
• 2021.2.6 A bug in dice was fixed with the help of Shanshan Li.
• 2021.2.24 A video tutorial was released(https://www.bilibili.com/video/BV1gp4y1H7kq/).
• 2021.5.16 A bug in Unet3D implement was fixed.
• 2021.5.16 The metric code is released.
• 2021.6.24 All parameters can be adjusted in hparam.py.
• 2021.7.7 Now you can refer medical classification in Pytorch-Medical-Classification

Requirements

• pytorch1.7
• torchio<=0.18.20
• python>=3.6

Notice

• You can modify hparam.py to determine whether 2D or 3D segmentation and whether multicategorization is possible.
• We provide algorithms for almost all 2D and 3D segmentation.
• This repository is compatible with almost all medical data formats(e.g. nii.gz, nii, mhd, nrrd, ...), by modifying fold_arch in hparam.py of the config. I would like you to convert both the source and label images to the same type before using them, where labels are marked with 1, not 255.
• If you want to use a multi-category program, please modify the corresponding codes by yourself. I cannot identify your specific categories.
• Whether in 2D or 3D, this project is processed using patch. Therefore, images do not have to be strictly the same size. In 2D, however, you should set the patch large enough.

Prepare Your Dataset

Example1

if your source dataset is :

source_dataset
├── source_1.mhd
├── source_1.zraw
├── source_2.mhd
├── source_2.zraw
├── source_3.mhd
├── source_3.zraw
├── source_4.mhd
├── source_4.zraw
└── ...

and your label dataset is :

label_dataset
├── label_1.mhd
├── label_1.zraw
├── label_2.mhd
├── label_2.zraw
├── label_3.mhd
├── label_3.zraw
├── label_4.mhd
├── label_4.zraw
└── ...

then your should modify fold_arch as *.mhd, sourcetraindir as source_dataset and labeltraindir as label_dataset in hparam.py

Example2

if your source dataset is :

source_dataset
├── 1
    ├── source_1.mhd
    ├── source_1.zraw
├── 2
    ├── source_2.mhd
    ├── source_2.zraw
├── 3
    ├── source_3.mhd
    ├── source_3.zraw
├── 4
    ├── source_4.mhd
    ├── source_4.zraw
└── ...

and your label dataset is :

label_dataset
├── 1
    ├── label_1.mhd
    ├── label_1.zraw
├── 2
    ├── label_2.mhd
    ├── label_2.zraw
├── 3
    ├── label_3.mhd
    ├── label_3.zraw
├── 4
    ├── label_4.mhd
    ├── label_4.zraw
└── ...

then your should modify fold_arch as */*.mhd, sourcetraindir as source_dataset and labeltraindir as label_dataset in hparam.py

Training

• without pretrained-model

  set hparam.train_or_test to 'train'
  python main.py
  

• with pretrained-model

  set hparam.train_or_test to 'train'
  python main.py -k True
  

Inference

• testing

  set hparam.train_or_test to 'test'
  python main.py
  

Examples

Tutorials

• https://www.bilibili.com/video/BV1gp4y1H7kq/

Done

Network

• 2D
• [x] unet
• [x] unet++
• [x] miniseg
• [x] segnet
• [x] pspnet
• [x] highresnet(copy from https://github.com/fepegar/highresnet, Thank you to fepegar for your generosity!)
• [x] deeplab
• [x] fcn
• 3D
• [x] unet3d
• [x] residual-unet3d
• [x] densevoxelnet3d
• [x] fcn3d
• [x] vnet3d
• [x] highresnert(copy from https://github.com/fepegar/highresnet, Thank you to fepegar for your generosity!)
• [x] densenet3d
• [x] unetr (copy from https://github.com/tamasino52/UNETR)

Metric

• [x] metrics.py to evaluate your results

TODO

• [ ] dataset
• [ ] benchmark
• [ ] nnunet

By The Way

This project is not perfect and there are still many problems. If you are using this project and would like to give the author some feedbacks, you can send Kangneng Zhou an email.

Acknowledgements

This repository is an unoffical PyTorch implementation of Medical segmentation in 3D and 2D and highly based on MedicalZooPytorch and torchio.Thank you for the above repo. Thank you to Cheng Chen, Youming Zhang, Daiheng Gao, Jie Zhang, Xing Tao, Weili Jiang and Shanshan Li for all the help I received.