Skip to content

ClinicaDL Documentation

ClinicaDL is the deep learning extension of Clinica, an open-source Python library for neuroimaging preprocessing and analysis. This library was developed from the AD-DL project, a GitHub repository hosting the source code of a scientific publication on the deep learning classification of brain images in the context of Alzheimer's disease. This is why some functions (label definition and data set restriction) of ClinicaDL are still specific to Alzheimer's disease context. For more information on this clinical context, please refer to our tutorial.

If you are new to ClinicaDL, please consider reading the First steps section before starting your project!

ClinicaDL tutorial

Visit our hands-on tutorial web site to try ClinicaDL directly in a Google Colab instance!


See Installation section for detailed instructions.

ClinicaDL can be installed on Mac OS X and Linux machines, and possibly on Windows computers with a Linux Virtual Machine.

We assume that users installing and using ClinicaDL are comfortable using the command line.

User documentation (ClinicaDL)

Prepare your metadata

Prepare your imaging data

Hyperparameter exploration

Train deep learning networks

Inference using pretrained models

Network output serialization

Interpretation with gradient maps



If you want to contribute but are not familiar with GitHub, please read the Contribute section. You will also find how to run the test suite to check that your modifications are ready to be integrated.


ClinicaDL is distributed under the terms of the MIT license given here.

Citing ClinicaDL

For publications or communications using ClinicaDL, please cite [Wen et al., 2020] as well as the references mentioned on the wiki page of the pipelines you used (for example, citing PyTorch when using the extract pipeline).


ClinicaDL is a software for research studies. It is not intended for use in medical routine.