Skip to main content

Software platform for clinical neuroimaging studies

Project description

Logo
Clinica

Software platform for clinical neuroimaging studies

Build Status PyPI version platform

Homepage | Documentation | Preprint | Forum | See also: AD-ML, AD-DL

About The Project

Clinica is a software platform for clinical research studies involving patients with neurological and psychiatric diseases and the acquisition of multimodal data (neuroimaging, clinical and cognitive evaluations, genetics...), most often with longitudinal follow-up.

Clinica is command-line driven and written in Python. It uses the Nipype system for pipelining and combines widely-used software packages for neuroimaging data analysis (ANTs, FreeSurfer, FSL, MRtrix, PETPVC, SPM), machine learning (Scikit-learn) and the BIDS standard for data organization.

Clinica provides tools to convert publicly available neuroimaging datasets into BIDS, namely:

Clinica can process any BIDS-compliant dataset with a set of complex processing pipelines involving different software packages for the analysis of neuroimaging data (T1-weighted MRI, diffusion MRI and PET data). It also provides integration between feature extraction and statistics, machine learning or deep learning.

ClinicaPipelines

Clinica is also showcased as a framework for the reproducible classification of Alzheimer's disease using machine learning and deep learning.

Getting Started

Full instructions for installation and additional information can be found in the user documentation.

Clinica currently supports macOS and Linux. It can be installed by typing the following command:

pip install clinica

To avoid conflicts with other versions of the dependency packages installed by pip, it is strongly recommended to create a virtual environment before the installation. For example, use Conda, to create a virtual environment and activate it before installing clinica (you can also use virtualenv):

conda create --name clinicaEnv python=3.7
conda activate clinicaEnv

Depending on the pipeline that you want to use, you need to install pipeline-specific interfaces. Not all the dependencies are necessary to run Clinica. Please refer to this page to determine which third-party libraries you need to install.

Example

Diagram illustrating the Clinica pipelines involved when performing a group comparison of FDG PET data projected on the cortical surface between patients with Alzheimer's disease and healthy controls from the ADNI database:

ClinicaExample

  1. Clinical and neuroimaging data are downloaded from the ADNI website and data are converted into BIDS with the adni-to-bids converter.
  2. Estimation of the cortical and white surface is then produced by the t1-freesurfer pipeline.
  3. FDG PET data can be projected on the subject’s cortical surface and normalized to the FsAverage template from FreeSurfer using the pet-surface pipeline.
  4. TSV file with demographic information of the population studied is given to the statistics-surface pipeline to generate the results of the group comparison.

For more examples and details, please refer to the Documentation.

Support

License

This software is distributed under the MIT License. See license file for more information.

Citing us

  • Routier, A., Burgos, N., Díaz, M., Bacci, M., Bottani, S., El-Rifai O., Fontanella, S., Gori, P., Guillon, J., Guyot, A., Hassanaly, R., Jacquemont, T., Lu, P., Marcoux, A., Moreau, T., Samper-González, J., Teichmann, M., Thibeau-Sutre, E., Vaillant G., Wen, J., Wild, A., Habert, M.-O., Durrleman, S., and Colliot, O.: ‘Clinica: An Open Source Software Platform for Reproducible Clinical Neuroscience Studies’, 2021. hal-02308126

Related Repositories

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

clinica-0.5.0rc2.tar.gz (558.7 kB view details)

Uploaded Source

Built Distribution

clinica-0.5.0rc2-py2.py3-none-any.whl (707.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file clinica-0.5.0rc2.tar.gz.

File metadata

  • Download URL: clinica-0.5.0rc2.tar.gz
  • Upload date:
  • Size: 558.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.0.post20201006 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.7

File hashes

Hashes for clinica-0.5.0rc2.tar.gz
Algorithm Hash digest
SHA256 b0052ea79d7745426ab9f289440109004c5e965c40227cbbbc204ae6e761f66d
MD5 74c328beb32b8a162a62eb634c63fe1c
BLAKE2b-256 fffd18d66992a804db56d745e9aeefba8334e84f4e213bde8b67278e178e9899

See more details on using hashes here.

File details

Details for the file clinica-0.5.0rc2-py2.py3-none-any.whl.

File metadata

  • Download URL: clinica-0.5.0rc2-py2.py3-none-any.whl
  • Upload date:
  • Size: 707.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.0.post20201006 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.7

File hashes

Hashes for clinica-0.5.0rc2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 80e3bc4c4130907cc1e12ebb68e30557e2f9181ac9670308c2bf0f22cd42cf9b
MD5 bf77ef3f45487c67cbc5ff218cb74a5e
BLAKE2b-256 9d5b0d973d46e6774864b04bdb59af7e4834e9da4b09df48cc530b8c627d01c8

See more details on using hashes here.

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