Skip to content

MMIV-ML/fastMONAI

Repository files navigation

Overview

CI Docs PyPI

A low-code Python-based open source deep learning library built on top of fastai, MONAI, TorchIO, and Imagedata.

fastMONAI simplifies the use of state-of-the-art deep learning techniques in 3D medical image analysis for solving classification, regression, and segmentation tasks. fastMONAI provides the users with functionalities to step through data loading, preprocessing, training, and result interpretations.

Note: This documentation is also available as interactive notebooks.

Installing

From PyPI

pip install fastMONAI

From GitHub

If you want to install an editable version of fastMONAI run:

  • git clone https://github.com/MMIV-ML/fastMONAI
  • pip install -e 'fastMONAI[dev]'

Getting started

The best way to get started using fastMONAI is to read our paper and dive into our beginner-friendly video tutorial. For a deeper understanding and hands-on experience, our comprehensive instructional notebooks will walk you through model training for various tasks like classification, regression, and segmentation. See the docs at https://fastmonai.no for more information.

Notebook 1-Click Notebook
10a_tutorial_classification.ipynb
shows how to construct a binary classification model based on MRI data.
Google Colab
10b_tutorial_regression.ipynb
shows how to construct a model to predict the age of a subject from MRI scans (“brain age”).
Google Colab
10c_tutorial_binary_segmentation.ipynb
shows how to do binary segmentation (extract the left atrium from monomodal cardiac MRI).
Google Colab
10d_tutorial_multiclass_segmentation.ipynb
shows how to perform segmentation from multimodal MRI (brain tumor segmentation).
Google Colab

How to contribute

See CONTRIBUTING.md

Citing fastMONAI

If you are using fastMONAI in your research, please use the following citation:

@article{KALIYUGARASAN2023100583,
title = {fastMONAI: A low-code deep learning library for medical image analysis},
journal = {Software Impacts},
pages = {100583},
year = {2023},
issn = {2665-9638},
doi = {https://doi.org/10.1016/j.simpa.2023.100583},
url = {https://www.sciencedirect.com/science/article/pii/S2665963823001203},
author = {Satheshkumar Kaliyugarasan and Alexander S. Lundervold},
keywords = {Deep learning, Medical imaging, Radiology},
abstract = {We introduce fastMONAI, an open-source Python-based deep learning library for 3D medical imaging. Drawing upon the strengths of fastai, MONAI, and TorchIO, fastMONAI simplifies the use of advanced techniques for tasks like classification, regression, and segmentation. The library's design addresses domain-specific demands while promoting best practices, facilitating efficient model development. It offers newcomers an easier entry into the field while keeping the option to make advanced, lower-level customizations if needed. This paper describes the library's design, impact, limitations, and plans for future work.}
}