Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Quality control metrics for data processed using Prantik Kundu's Multi-Echo Independent Components Analysis (ME-ICA).

Build Status Coverage Status


ME-ICA minimally requires (1) acquired echo times (in milliseconds) and (2) functional datasets equal to the number of acquired echoes. But you can supply many other options, viewable with -h.

Here's one example use case: -d 'sub-001_task-rest_echo-[1,2,3]_run-01_meep1.nii.gz' -e 15,30,45 -b 12s -a 'sub-001_T1w.nii.gz' --MNI


-e 15,30,45 are the echo times in milliseconds
-d 'sub-001_task-rest_echo-[1,2,3]_run-01_meep1.nii.gz' are the 4-D multi-echo fMRI datasets. Can supply each dataset individually or with bash shell expansion
-a 'sub-001_T1w.nii.gz' is an anatomical image with skull
-b 12s means drop first 12 seconds of data for equilibration
--MNI warp anatomical to MNI space using AFNI's MNI_caez_N27 (Colin 27) template.

Additional, optional parameters support situations such as: anatomical with no skull, applying FWHM smoothing, non-linear warping, etc.


PROCEDURE 1 : Preprocess multi-echo datasets and apply multi-echo ICA based on spatial concatenation -Check arguments, input filenames, and filesystem for dependencies -Calculation of motion parameters based on images with highest constrast -Application of motion correction and coregistration parameters -Misc. EPI preprocessing (temporal alignment, smoothing, etc) in appropriate order -Compute PCA and ICA in conjuction with TE-dependence analysis


  • *_medn.nii.gz : 'Denoised' BOLD time series after: basic preprocessing, T2* weighted averaging of echoes (i.e. 'optimal combination'), ICA denoising. Use this dataset for task analysis and resting state time series correlation analysis.
  • *_tsoc.nii.gz : 'Raw' BOLD time series dataset after: basic preprocessing and T2* weighted averaging of echoes (i.e. 'optimal combination'). 'Standard' denoising or task analyses can be assessed on this dataset (e.g. motion regression, physio correction, scrubbing, blah...) for comparison to ME-ICA denoising.
  • *_mefc.nii.gz : Component maps (in units of \delta S) of accepted BOLD ICA components. Use this dataset for ME-ICR seed-based connectivity analysis.
  • *_mefl.nii.gz : Component maps (in units of \delta S) of ALL ICA components.
  • *_ctab.nii.gz : Table of component Kappa, Rho, and variance explained values, plus listing of component classifications.

Some Notes

  • Make sure your datasets have slice timing information in the header. If not sure, specify a --tpattern option to Check AFNI documentation of 3dTshift to see slice timing codes.
  • FWHM smoothing is not recommended. tSNR boost is provided by optimal combination of echoes. For better overlap of 'blobs' across subjects, use non-linear standard space normalization instead with ... --qwarp


If you use ME-ICA in publications, please cite:

Kundu, P., Brenowitz, N.D., Voon, V., Worbe, Y., Vertes, P.E., Inati, S.J., Saad, Z.S., Bandettini, P.A. & Bullmore, E.T. Integrated strategy for improving functional connectivity mapping using multiecho fMRI. PNAS (2013).

Kundu, P., Inati, S.J., Evans, J.W., Luh, W.M. & Bandettini, P.A. Differentiating BOLD and non-BOLD signals in fMRI time series using multi-echo EPI. NeuroImage (2011).


quality control for data processed with ME-ICA







No releases published


No packages published

Contributors 4