New release
  CMP v2.1.0-beta

  •  •Preprocessing: Motion and eddy current correction
  •  •Custom atlases
  •  •New reconstuction schemes: CSD, ballstick, multitensor...
  •  •Probabilistic tractography: Camino, MRtrix, FSL probtrackx
  •  •Global tractography: Gibbs-tracker

Table Of Contents

Previous topic

Project configuration

Next topic

Example Results

This Page

Stage configuration

Each stage has a configuration and a “View outputs” panel. The configuration panel allows to set the stage parameters. The “View outputs” panel displays a set of outputs that can be visually checked once the stage processing has finished. The outputs depend on the chosen parameters.

Stage documentation for the previous release (v1.2.0) are available here


Preprocessing includes motion and eddy current correction for diffusion data.


Motion correction

Aligns diffusion volumes to the b0 volume using FSL’s MCFLIRT.


For hemi-sphere DSI aquisitions, warning outputs will be displayed in the console when processing empty volumes.

Eddy current correction

Corrects for eddy current distortions using FSL’s Eddy correct tool.

View outputs

  • Motion corrected image
  • Eddy current corrected image
  • Motion and eddy current corrected image


Performs tissue segmentation using Freesurfer or custom segmentation.


  • Freesurfer args: used to specify Freesurfer processing options
  • Use existing freesurfer data: Check this box if you have already Freesurfer output data available

Custom segmentation

  • White matter mask: select the file containing your white matter binary mask

View outputs

  • Brain mask
  • Segmentation labels overlaid on T1 (Freesurfer)
  • Segmentation and surfaces overlaid on T1 (Freesurfer)


Generates the Native Freesurfer or Lausanne2008 parcellation from Freesurfer data, or takes a custom parcellation atlas.

Parcellation scheme

  • NativeFreesurfer: Atlas composed of 83 regions from the Freesurfer aparc+aseg file
  • Lausanne2008: Multi-resolution atlas
  • Custom: Custom atlas. Specify the atlas name, the number of regions, the nifti file and a corresponding graphml file. The Graphml file must contain at least a “dn_correspondence_id” field for each node. This field should contain the region’s label in the nifti file.

View outputs

  • Freesurfer and Lausanne2008: Parcellation(s) overlaid with brain mask
  • Custom: Custom atlas


Registration mode

  • Linear (FSL): perform linear registration from T1 to diffusion b0 using FSL’s flirt.
  • BBregister (FS): perform linear registration using Freesurfer BBregister tool.
  • Non-linear (FSL): perform non-linear registration from T1 to b0 (only available if T2 scans are found).

View outputs

  • T1 volume registered to b0 space overlayed with the b0 volume.

Diffusion and tractography

Performs deterministic, probabilistic or global tractography based on several tools.


There is currently an issue with window resizing when changing processing tools. Close the window and reopen it when you change the processing tool.


Resample diffusion data to F0 x F1 x F2 mm^3

Processing tool


DTK: performs tensor reconstruction and deterministic fiber tracking. The algorithm ensures that fibers terminate in the grey matter (no ROI dilation required).

MRtrix: performs tensor and CSD reconstruction as well as deterministic and probabilistic fiber tracking. ROI dilation is required to map brain connections as the tracking only operates in the white matter.

  • Deterministic:


    Deterministic tracking performed on single tensor or CSD reconstruction

  • Probabilistic:


    Probabilistic tracking is currently only available from CSD reconstruction. Seed regions are defined as the intersection between dilated ROIs and the white matter mask.

Camino: performs multi model reconstruction and also deterministic and probabilistic fiber tracking. ROI dilation required as for MRtrix processing.

  • Deterministic:


    Deterministic tracking can be performed on single or multi-tensor reconstructions. Reconstructions using Ball-stick or Restore algorithms are also available.

  • Probabilistic:


    For now, probabilistic tracking with Camino only includes the “pico” tracking algorithm. Make sure that the trace units match your b-values in the gradient table.

FSL: performs probabilistic tracking


Gibbs: performs global tractography based on FSL tensor or MRtrix CSD reconstruction


View outputs

  • Fiber tracks (when deterministic of global tractography is performed)
  • Response function (Mrtrix CSD)


Computes fiber length connectivity matrices. If DTI or HARDI data is processed, FA additional map is computed. In case of DSI, additional maps include GFA, Skewness, Kurtosis and P0.


Output types

Select in which formats the connectivity matrices should be saved.

View outputs

Connectivity matrices in gpickle format: extracts and displays mean fiber length matrices


The Connectome Mapper processing relies on nipype. For each stage, a processing folder is created in $Base_directory/NIPYPE/diffusion_pipeline/<stage_name>.

All intermediate steps for the processing are saved in the corresponding stage folders.