Connectome Mapper 3

Latest released version: v3.0.0-RC3

This neuroimaging processing pipeline software is developed by the Connectomics Lab at the University Hospital of Lausanne (CHUV) for use within the SNF Sinergia Project 170873, as well as for open-source software distribution. Source code is hosted on GitHub.

Warning

THIS SOFTWARE IS FOR RESEARCH PURPOSES ONLY AND SHALL NOT BE USED FOR ANY CLINICAL USE. THIS SOFTWARE HAS NOT BEEN REVIEWED OR APPROVED BY THE FOOD AND DRUG ADMINISTRATION OR EQUIVALENT AUTHORITY, AND IS FOR NON-CLINICAL, IRB-APPROVED RESEARCH USE ONLY. IN NO EVENT SHALL DATA OR IMAGES GENERATED THROUGH THE USE OF THE SOFTWARE BE USED IN THE PROVISION OF PATIENT CARE.

About

Connectome Mapper 3 implements full anatomical, diffusion and resting-state MRI processing pipelines, from raw Diffusion / T1 / T2 / BOLD data to multi-resolution connection matrices.

Connectome Mapper 3 pipelines use a combination of tools from well-known software packages, including FSL, FreeSurfer, ANTs, MRtrix3, Dipy and AFNI, orchestrated by the Nipype dataflow library. These pipelines were designed to provide the best software implementation for each state of processing, and will be updated as newer and better neuroimaging software become available.

This tool allows you to easily do the following:

• Take T1 / Diffusion / resting-state MRI data from raw to multi-resolution connection matrices.

• Implement tools from different software packages.

• Achieve optimal data processing quality by using the best tools available

• Automate and parallelize processing steps, which provides a significant speed-up from typical linear, manual processing.

Reproducibility and replicatibility is achieved through the distribution of a BIDSApp, a software container image which provide a frozen environment where versions of all external softwares and libraries are fixed.

License information

This software is distributed under the open-source license Modified BSD. See license for more details.

All trademarks referenced herein are property of their respective holders.

Aknowledgment

If your are using the Connectome Mapper 3 in your work, please acknowledge this software. See Citing for more details.

Help/Questions

If you run into any problems or have any questions, you can post to the CMTK-users group. Code bugs can be reported by creating a “New Issue” on the source code repository.

Eager to contribute?

Connectome Mapper 3 is open-source and all kind of contributions (bug reporting, documentation, code,…) are welcome! See Contributing to Connectome Mapper for more details.

Contents

Getting started

• Installation Instructions for Users
  • The Connectome Mapper 3 BIDSApp
  • The Connectome Mapper 3 BIDSApp Manager (GUI)

User Documentation

• Connectome Mapper 3 and the BIDS standard
  • Example BIDS dataset
• Commandline Usage
  • Commandline Arguments
  • Participant Level Analysis
  • Debugging
  • Support, bugs and new feature requests
  • Not running on a local machine?
• Graphical User Interface
  • Introduction
  • Start the Graphical User Interface
  • Load a BIDS dataset
  • Pipeline stage configuration
  • Run the BIDS App
  • Check stages outputs
• Outputs of Connectome Mapper 3
  • BIDS derivatives entities
  • Anatomical derivatives
  • Diffusion derivatives
  • Functional derivatives

API Documentation

• Packages and modules
  • cmp package
    • Submodules
      • cmp.parser module
      • cmp.project module
    • Pipelines and stages modules
      • cmp.pipelines.common module
      • cmp.pipelines.anatomical package
      • cmp.pipelines.diffusion package
      • cmp.pipelines.functional package
      • cmp.stages package
    • GUI modules
      • cmp.bidsappmanager.core module
      • cmp.bidsappmanager.gui module
      • cmp.bidsappmanager.project module
      • cmp.bidsappmanager.pipelines.anatomical package
      • cmp.bidsappmanager.pipelines.diffusion package
      • cmp.bidsappmanager.pipelines.functional package
      • cmp.bidsappmanager.stages package
  • cmtklib package
    • Subpackages
      • cmtklib.bids package
      • cmtklib.interfaces package
    • Submodules
      • cmtklib.config module
      • cmtklib.connectome module
      • cmtklib.diffusion module
      • cmtklib.functionalMRI module
      • cmtklib.parcellation module
      • cmtklib.util module

Examples & Tutorials

• Adopting Datalad for collaboration
  • Move original BIDS dataset to server
  • Datalad setup and dataset creation on Server (accessible via ssh)
  • Processing using the Connectome Mapper BIDS App on a local workstation
  • Local collaboration with Bob for Electrical Source Imaging
• Running on a cluster (HPC)
  • Running the singularity image
  • Conversion to a Singularity image
  • Useful singularity commands

About Connectome Mapper

• BSD 3-Clause License
• Changes
• Citing
• Contributing to Connectome Mapper 3
• Support, Bugs and New Feature Requests

Funding

Work supported by the SNF Sinergia Grant 170873 (http://p3.snf.ch/Project-170873).