Core tools required for running Canlab Matlab toolboxes. The heart of this toolbox is object-oriented tools that enable interactive analysis of neuroimaging data and simple scripts using high-level commands tailored to neuroimaging analysis.
Clone or download

README.md

CanlabCore

This repository contains core tools for MRI/fMRI/PET analysis from the Cognitive and Affective Neuorscience Lab (Tor Wager, PI) and our collaborators. Many of these functions are needed to run other toolboxes, e.g., the CAN lab’s multilevel mediation and Martin Lindquist’s hemodynamic response estimation toolboxes. A brief introduction to the toolbox can be found here.

The tools include object-oriented tools for doing neuroimaging analysis with simple commands and scripts that provide high-level functionality for neuroimaging analysis. For example, there is an "fmri_data" object type that contains neuroimaging datasets (both PET and fMRI data are ok, despite the name). If you have created and object called my_fmri_data_obj, then plot(my_fmri_data_obj) will generate a series of plots specific to neuroimaging data, including an interactive brain viewer (courtesy of SPM software). predict(my_fmri_data_obj) will perform cross-validated multivariate prediction of outcomes based on brain data. ica(my_fmri_data_obj) will perform independent components analysis on the data, and so forth.

The repository also includes other useful toolboxes, including:

  • fMRI design optimization using a genetic algorithm (OptimizeGA)
  • fMRI hemodynamic response function estimation (HRF_Est_Toolbox2)
  • fMRI analysis with Hierarchical Exponentially Weighted Moving Average change-point analysis (hewma_utility)
  • Various fMRI diagnostics (diagnostics)
  • Miscellaneous other tools and functions for visualizing brain data

Getting help and additional information:

We have several sources of documentation for this toolbox:

  1. For a walk-through of a common basic processing pipeline, see our hackpad
  2. For function-by-function help documents on the Core Tools objects and functions, see the help pages on Readthedocs.
  3. For brief, documented code examples of some specific functions, and a batch script system that uses the CanlabCore object-oriented tools for second-level neuroimaging analysis, see CANlab_help_examples github repository

The CANlab website is https://canlabweb.colorado.edu/, and we also maintain a WIKI with more information on some of our toolboxes and fMRI analysis more generally, which is here. For more information on fMRI analysis generally, see Martin and Tor's online book and our free Coursera videos and classes Principles of fMRI Part 1 and Part 2 .

Dependencies: These should be installed to use this toolbox

Matlab www.mathworks.com

Matlab statistics toolbox

Matlab signal processing toolbox

Statistical Parametric Mapping (SPM) software https://www.fil.ion.ucl.ac.uk/spm/

matlab_bgl (graph theory) and spider (machine learning) toolboxes; these are included in this distribution

the CANlab Neuroimaging_Pattern_Masks repository https://github.com/canlab/Neuroimaging_Pattern_Masks

the canlab_help_examples repository https://github.com/canlab/CANlab_help_examples