Skip to main content

Feature conditioning for IVADO medical imaging project.

Project description

Coverage Status License: MIT

IVADO Medical Imaging

Comprehensive and open-source repository of deep learning methods for medical data segmentation. Collaboration between MILA and NeuroPoly for the IVADO project on medical imaging.

Contributions and features

Physic-informed network

We adapted the Feature-wise Linear Modulation (FiLM) approach to the segmentation task. FiLM enabled us to modulate CNNs features based on non-image metadata.

Figure FiLM

Two-step training with class sampling

We implemented a class sampling scheme, coupled with a transfer learning strategy, in order to mitigate the issue of class imbalance, while adressing the limitations of classical under-sampling (risk of loss of information) or over-sampling (risk of overfitting) approaches. During a first training step, the CNN is trained on an equivalent proportion of positive and negative samples, negative samples being under-weighted dynamically at each epoch. During the second step, the CNN is fine-tuned on the realistic (i.e. class-imbalanced) dataset.


Mixup is a data augmentation technique which trains on virtual samples, generated by linear interpolation of two random samples from the training set and the associated labels. The idea is to regularize the network by linearly interpolating between training samples while extending the training distribution.

Figure mixup

Data augmentation on lesion ground-truths

This data augmentation is motivated by the large inter-rater variability that we measured on our MS dataset. The raters indeed mainly disagreed on the boundaries of the lesions, which suggests that the lesion surrounding voxels may also include some lesion level information. A soft mask is constructed by morphological dilation of the binary segmentation (i.e. mask provided by expert), where expert-labeled voxels have one as value while the augmented voxels are assigned a soft value which depends on the distance to the core of the lesion. Thus, the prior knowledge about the subjective lesion borders is then leveraged to the network.

Figure Data Augmentation on lesion ground truths

Network architectures

Loss functions


This project requires Python 3.6 and PyTorch >= 1.5.0. We recommend you work under a virtual environment:

virtualenv venv-ivadomed --python=python3.6
source venv-ivadomed/bin/activate

Option 1 : development version from Github

ivadomed is installed from Github and the requirements are installed using pip:

git clone
cd ivado-medical-imaging
pip install -e .

Option 2 : release from PyPI

ivadomed and its requirements are installed directly using pip :

pip install --upgrade pip
pip install ivadomed


To train the network, use the ivadomed command-line tool that will be available on your path after installation, example below:

ivadomed config/config.json

where config.json is a configuration file. A description of each parameter is available in the wiki.


The working dataset are:

  1. derived from the Spinal Cord MRI Public Database.
  2. the spinal cord grey matter segmentation challenge dataset.
  3. private multi-center dataset (duke/sct_testing/large) for spinal cord and MS lesion segmentation task.

The data structure is compatible with BIDS and is exemplified below:

└── dataset_description.json
└── participants.tsv
└── sub-amu01
    └── anat
        └── sub-amu01_T1w_reg.nii.gz --> Processed (i.e. different than in the original SpineGeneric database)
        └── sub-amu01_T1w_reg.json
        └── sub-amu01_T2w_reg.nii.gz --> Processed
        └── sub-amu01_T2w_reg.json
        └── sub-amu01_acq-MTon_MTS_reg.nii.gz --> Processed
        └── sub-amu01_acq-MTon_MTS_reg.json
        └── sub-amu01_acq-MToff_MTS_reg.nii.gz --> Processed
        └── sub-amu01_acq-MToff_MTS_reg.json
        └── sub-amu01_acq-T1w_MTS.nii.gz --> Unprocessed (i.e. same as in the original SpineGeneric database)
        └── sub-amu01_acq-T1w_MTS.json
        └── sub-amu01_T2star_reg.nii.gz --> Processed
        └── sub-amu01_T2star_reg.json
└── derivatives
    └── labels
        └── sub-amu01
            └── anat
                └── sub-amu01_T1w_seg.nii.gz --> Spinal cord segmentation


List of contributors

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ivadomed-1.2.tar.gz (56.9 kB view hashes)

Uploaded Source

Built Distribution

ivadomed-1.2-py3-none-any.whl (68.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page