Skip to content
ljod edited this page Sep 5, 2014 · 36 revisions

Welcome to the whitematteranalysis wiki!

White Matter Analysis provides clustering and tractography analysis tools.

It implements algorithms from publications listed here: http://projects.iq.harvard.edu/whitematteranalysis/publications

Also see the github.io page here: http://ljod.github.io/whitematteranalysis/

Running the Clustering Pipeline

wm_registermultisubject.py

  • Runs a multisubject unbiased group registration of tractography.
  • This is used to before clustering the atlas and is typically used on the control subject data.

wm_cluster_atlas.py

  • Runs clustering of tractography for multiple subjects to create an atlas. Clusters can be viewed in Slicer following this step.
  • This step analyzes a subset of fibers from each subject to determine common structures in the population.

wm_label_from_atlas.py

  • Labels tractography for single cases according to the multi-subject cluster representation created in step 2
  • This code registers the atlas to the subject for comparison.
  • This analyzes the full subject dataset.

Additional command: wm_cluster_subject.py

  • Clusters tractography from a single subject
  • This is not commonly used. It is generally used for experimenting with one subject.

Help

  • In order to use any of the commands, “python” must be entered first
  • Commands can be entered from anywhere, but the entire path to the file must be used. In most cases, the required command is something like

python path_to_script path_to_input_directory path_to_output_directory

  • The output file(s) will be created in the output directory you specify. Generally, the directory will be created for you if it does not exist.

  • Clustering commands can be found in the bin directory of whitematteranalysis:

whitematteranalysis/bin/

  • To get the help menu for any of the scripts: Enter “python” then space, then the full path to the script, followed by “-h”. This can be run from any directory.
    Example:

% python whitematteranalysis/bin/wm_register_multisubject.py –h

Thank you to Julie Marie Stamm for her help writing these instructions.