No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Dependencies
.gitignore
BuildMatrices.m
ComputeCorrelationMatrix.m
ComputePWlinks.m
Iterative_SV.m
LICENSE.txt
MergeConnectivityMatrix.m
MergeConnectivityMatrix2.m
MultiAffinity.m
Ncut_multi.m
SingleParcellation.m
SpectralParcellation.m
example.m
generateSeedVertices.m
loadSubjectData.m
param.mat
readme.md

readme.md

Multi-scale Spectral Clustering Parcellation

This code provides a Matlab implementation of the extension of the multi-scale normalised cuts approach (Cour et al., CVPR, 2005) for group-wise connectivity-driven brain parcellation.

Please cite any of the corresponding papers if using the code:

-Parisot, S., Arslan, S., Passerat-Palmbach, J., Wells III, W.M., Rueckert, D.: Group-wise Parcellation of the Cortex Through Multi-scale Spectral Clustering. NeuroImage (2016)

-Parisot, S., Arslan, S., Passerat-Palmbach, J., Wells III, W.M., Rueckert, D.: Tractography-Driven Groupwise Multi-scale Parcellation of the Cortex. In: Information Processing in Medical Imaging. pp. 600–612. Springer (2015)

INSTALLATION

In order to include dependencies folders, run the following command from the main folder when starting Matlab:

 addpath(genpath('Dependencies'))

Binaries are provided, but if necessary, recompile the normalised cut mex functions (Ncut folder) by running 'CompileDir_simple.m' in the installation directory:

 CompileDir_simple('./Dependencies')

USAGE

The main functions for running the code are SpectralParcellation.m (group-wise parcellation) and SingleParcellation.m (single subject parcellation). We assume that each subject has a specific identification (it could be the file name), linked to the way the data is stored.

We provide an example (example.m file) using the file organisation of the Human Connectome Project database and a tractography matrix obtained from FSL's probtrackX (data not provided due to the large size of the matrices).
In order to run on a different dataset, the functions ComputeCorrelationMatrix.m and loadSubjectData.m have to be replaced.

Data requirements:
  • A connectivity matrix per subject (tractography or fMRI times series correlations for instance)
  • A triangular cortical surface mesh, with corresponding inflated sphere. (Note that the sphere is only necessary for uniform initialisation of the seeds for supervertex parcellation.)

DEPENDENCIES

This software requires several Matlab toolboxes to run. All dependencies are provided in the 'Dependencies' folder, except for the Human Connectome Project's workbench and FSL, which can be downloaded at:
http://www.humanconnectome.org/software/connectome-workbench.html
http://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FslInstallation
The dependencies to the workbench, FSL and cifti toolbox can be removed if no cifti files are used in the ComputeCorrelationMatrix.m and loadSubjectData.m functions.

Provided dependencies: