This repository hosts the MONAI tutorials.
Most of the examples and tutorials require matplotlib and Jupyter Notebook.
These can be installed with:
python -m pip install -U pip
python -m pip install -U matplotlib
python -m pip install -U notebook
Some of the examples may require optional dependencies. In case of any optional import errors, please install the relevant packages according to MONAI's installation guide. Or install all optional requirements with:
pip install -r https://raw.githubusercontent.com/Project-MONAI/MONAI/dev/requirements-dev.txt
Most of the Jupyter Notebooks have an "Open in Colab" button. Please right-click on the button, and select "Open Link in New Tab" to start a Colab page with the corresponding notebook content.
To use GPU resources through Colab, please remember to change the runtime type to GPU
:
- From the
Runtime
menu selectChange runtime type
- Choose
GPU
from the drop-down menu - Click
SAVE
This will reset the notebook and may ask you if you are a robot (these instructions assume you are not).
Running:
!nvidia-smi
in a cell will verify this has worked and show you what kind of hardware you have access to.
Some notebooks will require additional data. They can be downloaded by running the runexamples.sh script.
- For questions relating to the use of MONAI, please us our Discussions tab on the main repository of MONAI.
- For bugs relating to MONAI functionality, please create an issue on the main repository.
- For bugs relating to the running of a tutorial, please create an issue in this repository.
During integration testing, we run these notebooks. To save time, we modify variables to avoid unecessary for
loop
iterations. Hence, during training please use the variables max_epochs
and val_interval
for the number of training
epochs and validation interval, respectively.
If your notebook doesn't use the idea of epochs, then please add it to the variable doesnt_contain_max_epochs
in runner.sh
. This lets the runner know that it's not a problem if it doesn't find max_epochs
.
If you have any other variables that would benefit by setting them to 1
during testing, add them
to strings_to_replace
in runner.sh
.
2D classification
This notebook shows how to easily integrate MONAI features into existing PyTorch programs. It's based on the MedNIST dataset which is very suitable for beginners as a tutorial. This tutorial also makes use of MONAI's in-built occlusion sensitivity functionality.
2D segmentation
Training and evaluation examples of 2D segmentation based on UNet and synthetic dataset. The examples are standard PyTorch programs and have both dictionary-based and array-based versions.
3D classification
Training and evaluation examples of 3D classification based on DenseNet3D and IXI dataset. The examples are PyTorch Ignite programs and have both dictionary-based and array-based transformation versions.
Training and evaluation examples of 3D classification based on DenseNet3D and IXI dataset. The examples are standard PyTorch programs and have both dictionary-based and array-based transformation versions.
3D segmentation
Training and evaluation examples of 3D segmentation based on UNet3D and synthetic dataset. The examples are PyTorch Ignite programs and have both dictionary-base and array-based transformations.
Training, evaluation and inference examples of 3D segmentation based on UNet3D and synthetic dataset. The examples are standard PyTorch programs and have both dictionary-based and array-based versions.
This tutorial shows how to construct a training workflow of multi-labels segmentation task based on MSD Brain Tumor dataset.
This notebook shows how MONAI may be used in conjunction with the aimhubio/aim
.
This notebook shows how MONAI may be used in conjunction with the PyTorch Lightning framework.
This notebook is an end-to-end training and evaluation example of 3D segmentation based on MSD Spleen dataset. The example shows the flexibility of MONAI modules in a PyTorch-based program:
- Transforms for dictionary-based training data structure.
- Load NIfTI images with metadata.
- Scale medical image intensity with expected range.
- Crop out a batch of balanced image patch samples based on positive / negative label ratio.
- Cache IO and transforms to accelerate training and validation.
- 3D UNet, Dice loss function, Mean Dice metric for 3D segmentation task.
- Sliding window inference.
- Deterministic training for reproducibility.
This notebook shows how MONAI may be used in conjunction with the Catalyst framework.
This notebook is an end-to-end training & evaluation example of 3D segmentation based on synthetic dataset. The example is a PyTorch Ignite program and shows several key features of MONAI, especially with medical domain specific transforms and event handlers for profiling (logging, TensorBoard, MLFlow, etc.).
This folder provides a simple baseline method for training, validation, and inference for COVID-19 LUNG CT LESION SEGMENTATION CHALLENGE - 2020 ( a MICCAI Endorsed Event).
This notebook demonstrates how to construct a training workflow of UNETR on multi-organ segmentation task using the BTCV challenge dataset.
This tutorial demonstrates how MONAI can be used in conjunction with PyTorch Lightning framework to construct a training workflow of UNETR on multi-organ segmentation task using the BTCV challenge dataset.
2D registration
This notebook shows a quick demo for learning based affine registration of 64 x 64
X-Ray hands.
3D registration
This tutorial shows how to use MONAI to register lung CT volumes acquired at different time points for a single patient.
This tutorial demonstrates the use of MONAI for training of registration and segmentation models together. The DeepAtlas approach, in which the two models serve as a source of weakly supervised learning for each other, is useful in situations where one has many unlabeled images and just a few images with segmentation labels. The notebook works with 3D images from the OASIS-1 brain MRI dataset.
deepgrow
The example show how to train/validate a 2D/3D deepgrow model. It also demonstrates running an inference for trained deepgrow models.
DeepEdit
This example shows how to train/test a DeepEdit model. In this tutorial there is a Notebook that shows how to run inference on a pretrained DeepEdit model.
deployment
This is a simple example of training and deploying a MONAI network with BentoML as a web server, either locally using the BentoML respository or as a containerized service.
This uses the previous notebook's trained network to demonstrate deployment a web server using Ray.
federated learning
The examples show how to train federated learning models with NVFlare and MONAI-based trainers.
The examples show how to train federated learning models based on OpenFL and MONAI.
The example show how to execute the 3d segmentation torch tutorial on a federated learning platform, Substra.
Digital Pathology
The example show how to train and evaluate a tumor detection model (based on patch classification) on whole-slide histopathology images.
The example show how to use MONAI NVTX transforms to tag and profile pre- and post-processing transforms in the digital pathology whole slide tumor detection pipeline.
acceleration
The document introduces details of how to profile the training pipeline, how to analyze the dataset and select suitable algorithms, and how to optimize GPU utilization in single GPU, multi-GPUs or even multi-nodes.
The examples show how to execute distributed training and evaluation based on 3 different frameworks:
- PyTorch native
DistributedDataParallel
module withtorch.distributed.launch
. - Horovod APIs with
horovodrun
. - PyTorch ignite and MONAI workflows.
They can run on several distributed nodes with multiple GPU devices on every node.
And compares the training speed and memory usage with/without AMP.
This notebook compares the performance of Dataset
, CacheDataset
and PersistentDataset
. These classes differ in how
data is stored (in memory or on disk), and at which moment transforms are applied.
This tutorial compares the training performance of pure PyTorch program and optimized program in MONAI based on NVIDIA
GPU device and latest CUDA library. The optimization methods mainly include: AMP
, CacheDataset
, GPU transforms
, ThreadDataLoader
, DiceCELoss
and SGD
.
This notebook is a quick demo for devices, run the Ignite trainer engine on CPU, GPU and multiple GPUs.
Demonstrates the use of the ThreadBuffer
class used to generate data batches during training in a separate thread.
Illustrate reading NIfTI files and test speed of different transforms on different devices.
modules
Get started tutorial and concrete training / inference examples for MONAI bundle features.
Training and evaluation examples of 3D segmentation based on UNet3D and synthetic dataset with MONAI workflows, which
contains engines, event-handlers, and post-transforms. And GAN training and evaluation example for a medical image
generative adversarial network. Easy run training script uses GanTrainer
to train a 2D CT scan reconstruction network.
Evaluation script generates random samples from a trained network.
The examples are built with MONAI workflows, mainly contain: trainer/evaluator, handlers, post_transforms, etc.
This notebook demonstrates the transformations on volumetric images.
Tutorial that demonstrates how monai SlidingWindowInferer
can be used when a 3D volume input needs to be provided
slice-by-slice to a 2D model and finally, aggregated into a 3D volume.
This tutorial uses the MedNIST hand CT scan dataset to demonstrate MONAI's autoencoder class. The autoencoder is used with an identity encode/decode (i.e., what you put in is what you should get back), as well as demonstrating its usage for de-blurring and de-noising.
Tutorial to explain and show how to set batch_transform
and output_transform
of handlers to work with MONAI engines.
Example shows how to compute metrics from saved predictions and labels with PyTorch multi-processing support.
Tutorial shows the usage of CSVDataset
and CSVIterableDataset
, load multiple CSV files and execute postprocessing
logic.
Tutorial shows how to decollate batch data to simplify post processing transforms and execute more flexible following operations.
Notebook introduces basic usages of monai.data.ImageDataset
module.
This tutorial shows how to train 3D segmentation tasks on all the 10 decathlon datasets with the reimplementation of dynUNet in MONAI.
This tutorial shows how to integrate 3rd party transforms into MONAI program. Mainly shows transforms from BatchGenerator, TorchIO, Rising and ITK.
This notebook demonstrates the use of invertible transforms, and then leveraging inverse transformations to perform test-time augmentations.
This notebook demonstrates how to select or filter out expected network layers and set customized learning rate values.
This notebook demonstrates how to use LearningRateFinder
API to tune the learning rate values for the network.
This notebook introduces how to easily load different formats of medical images in MONAI and execute many additional operations.
This notebook illustrates the use of MONAI for training a network to generate images from a random input tensor. A simple GAN is employed to do with a separate Generator and Discriminator networks.
This notebook shows the GanTrainer
, a MONAI workflow engine for modularized adversarial learning. Train a medical
image reconstruction network using the MedNIST hand CT scan dataset. Dictionary version.
This notebook shows the GanTrainer
, a MONAI workflow engine for modularized adversarial learning. Train a medical
image reconstruction network using the MedNIST hand CT scan dataset. Array version.
This tutorial shows how to leverage CrossValidation
, EnsembleEvaluator
, MeanEnsemble
and VoteEnsemble
modules in
MONAI to set up cross validation and ensemble program.
Illustrate reading NIfTI files and iterating over image patches of the volumes loaded from them.
This tutorial illustrates the flexible network APIs and utilities.
This notebook shows the usage of several postprocessing transforms based on the model output of spleen segmentation task.
This notebook shows how to quickly set up training workflow based on MedNISTDataset
and DecathlonDataset
, and how to
create a new dataset.
This notebook shows how to load the TCIA data with CSVDataset from CSV file and extract information for TCIA data to fetch DICOM images based on REST API.
This notebook demonstrates the image transformations on histology images using the GlaS Contest dataset.
This tutorial shows how to determine a reasonable spatial size of the input data for MONAI UNet, which not only supports
residual units, but also can use more hyperparameters (like strides
, kernel_size
and up_kernel_size
) than the
basic UNet implementation.
This notebook demonstrates how the three libraries from the official PyTorch Ecosystem can be used together to segment the hippocampus on brain MRIs from the Medical Segmentation Decathlon.
This tutorial uses the MedNIST scan (or alternatively the MNIST) dataset to demonstrate MONAI's variational autoencoder class.
Tutorials in this folder demonstrate model visualisation and interpretability features of MONAI. Currently, it consists of class activation mapping and occlusion sensitivity for 3D classification model visualisations and analysis.
This tutorial demonstrates a transfer learning pipeline from a pretrained model in Clara Train's Medical Model Archive format. The notebook also shows the use of LMDB-based dataset.
This tutorial shows several visualization approaches for 3D image during transform augmentation.