License
This toolbox is being modified to be compliant with an Apache 2.0 license.
Link to zip
A nightly build (zip) can be downloaded at https://miplab.epfl.ch/index.php/software/total-activation
Description
Toolbox with functions and scripts to obtain innovation-driven coactivation patterns (iCAPs) from fMRI data. Main steps of the pipeline are:
- Total activation for regularized deconvolution of fMRI data
- Thresholding of innovation frames based on surrogate data
- Clustering of innovation frames to extract spatial brain activity patterns
- Spatio-temporal regression for time course recovery of networks
The toolbox includes a README and example data and scripts for two subjects downloaded from the OpenfMRI database. Look at the example main and input scripts to see how to run the complete pipeline on the example fMRI data of two subjects. Note that the results are not stable for this few data, the example only exists to demonstrate how input and output data is saved.
Installation and updates
For installation, clone this repository using git:
git clone --depth=1 https://c4science.ch/source/iCAPs
Cloning may take a while, because the example data takes up some space (~5GB). To get the latest update of the toolbox, use
git pull
References
For details about the algorithms please refer to:
- Using iCAPs to reveal functional networks
- Karahanoglu, F. I. and Van De Ville, D. (2015). Transient brain activity disentangles fMRI resting-state dynamics in terms of spatially and temporally overlapping networks. Nat. Commun., 6:7751.
- Van De Ville, D. and Karahanoglu, F. I. (2016). Resting-State Neuroimaging Unravels Functional Organization in the Brain. SPIE Newsroom, August 15.
- Total activation deconvolution:
- Karahanoglu, F. I., Bayram, I., and Van De Ville, D. (2011).A Signal Processing Approach to Generalized 1-D Total Variation. IEEE Trans. Signal Process., 59(11):5265{5274.
- Karahanoglu, F. I., Caballero-Gaudes, C., Lazeyras, F., and Van De Ville, D. (2013). Total activation: FMRI deconvolution through spatio-temporal regularization. Neuroimage, 73:121{134.
- Farouj, Y., Karahanoglu, F. I., and Van De Ville, D. (2017). Regularized Spatiotemporal Deconvolution of fMRI Data Using Gray-Matter Constrained Total Variation. Proc. 14th IEEE Int. Symp. Biomed. Imaging From Nano to Macro, pages 472-475.
- Transient-informed regression:
- Zöller, D. M., Bolton, T. A. W., Karahanoglu, F. I., Eliez, S., Schaer, M., and Van De Ville, D. V. D. (in press). Robust recovery of temporal overlap between network activity using transient-informed spatiotemporal regression. IEEE Transactions on Medical Imaging
- More background about dynamic functional connectivity:
- Preti, M. G., Bolton, T., Van De Ville, D. (2017). The Dynamic Functional Connectome: State-of-the-Art and Perspectives. NeuroImage 160, pages 41-54.
- Karahanoglu, F.I., Van De Ville, D. (2017). Dynamics of Large-Scale fMRI Networks: Deconstruct Brain Activity to Build Better Models of Brain Function. Current Opinion in Biomedical Engineering 3, pages 28-36.
Contact
If you have any questions, error reports or if you simply want to chat about iCAPs, feel free to contact: younes.farouj@epfl.ch
History
Initial algorithm & code development: Isik Karahanoglu
Toolbox v1.0 implementation: Thomas Bolton
Implementation of publicly available toolbox on c4science: Daniela Zöller
Current maintenance & contact: Younes Farouj