Pre-configured Pipelines

human

default: The Default Pipeline

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_default.yml

Note

C-PAC runs this pipeline by default, and it is not necessary to invoke the –preconfig flag to run it.

Note

Changed in version 1.8.5: This pipeline was modified during the v1.8.5 release cycle. See Version 1.8.5 Beta (May 24, 2023) for details. The previous default pipeline has been preserved as default-deprecated

C-PAC is packaged with a default processing pipeline so that you can get your data preprocessing and analysis started immediately. Just pull the C-PAC Docker container and kick off the container with your data, and you’re on your way.

The default processing pipeline performs fMRI processing using four strategies, with and without global signal regression, with and without bandpass filtering.

Anatomical processing begins with conforming the data to RPI orientation and removing orientation header information that will interfere with further processing. A non-linear transform between skull-on images and a 2mm MNI brain-only template are calculated using ANTs[1].

Changed in version 1.8.5: Images are them skull-stripped using FSL’s BET[2] (was using AFNI’s 3dSkullStrip[3] prior to v1.8.5. See Version 1.8.5 Beta (May 24, 2023) for details.) and subsequently segmented into WM, GM, and CSF using FSL’s FAST tool[4].

The resulting WM mask was multiplied by a WM prior map that was transformed into individual space using the inverse of the linear transforms previously calculated during the ANTs procedure. A CSF mask was multiplied by a ventricle map derived from the Harvard-Oxford atlas distributed with FSL[5]. Skull-stripped images and grey matter tissue maps are written into MNI space at 2mm resolution.

Functional preprocessing begins with resampling the data to RPI orientation, and slice timing correction. Next, motion correction is performed using a two-stage approach in which the images are first coregistered to the mean fMRI and then a new mean is calculated and used as the target for a second coregistration (AFNI 3dvolreg[6]). A 7 degree of freedom linear transform between the mean fMRI and the structural image is calculated using FSL’s implementation of boundary-based registration[4]. Nuisance variable regression (NVR) is performed on motion corrected data using a 2nd order polynomial, a 24-regressor model of motion[7], 5 nuisance signals, identified via principal components analysis of signals obtained from white matter (CompCor[8]), and mean CSF signal. WM and CSF signals were extracted using the previously described masks after transforming the fMRI data to match them in 2mm space using the inverse of the linear fMRI-sMRI transform. The NVR procedure is performed twice, with and without the inclusion of the global signal as a nuisance regressor. The residuals of the NVR procedure are processed with and without bandpass filtering (0.01Hz < f < 0.1Hz), written into MNI space at 3mm resolution and subsequently smoothed using a 6mm FWHM kernel.

Several different individual level analysis are performed on the fMRI data including:

  • Amplitude of low frequency fluctuations (alff)[9]: the variance of each voxel is calculated after bandpass filtering in original space and subsequently written into MNI space at 2mm resolution and spatially smoothed using a 6mm FWHM kernel.

  • Fractional amplitude of low frequency fluctuations (falff)[10]: Similar to alff except that the variance of the bandpassed signal is divided by the total variance (variance of non-bandpassed signal).

  • Regional homogeneity (ReHo)[11]: a simultaneous Kendall rank correlation is calculated between each voxel’s time course and the time courses of the 27 voxels that are face, edge, and corner touching the voxel. ReHo is calculated in original space and subsequently written into MNI space at 2mm resolution and spatially smoothed using a 6mm FWHM kernel.

  • Voxel mirrored homotopic connectivity (VMHC)[12]: an non-linear transform is calculated between the skull-on anatomical data and a symmetric brain template in 2mm space. Using this transform, processed fMRI data are written in to symmetric MNI space at 2mm and the correlation between each voxel and its analog in the contralateral hemisphere is calculated. The Fisher transform is applied to the resulting values, which are then spatially smoothed using a 6mm FWHM kernel.

  • Weighted and binarized degree centrality (DC)[13]: fMRI data is written into MNI space at 2mm resolution and spatially smoothed using a 6mm FWHM kernel. The voxel x voxel similarity matrix is calculated by the correlation between every pair of voxel time courses and then thresholded so that only the top 5% of correlations remain. For each voxel, binarized DC is the number of connections that remain for the voxel after thresholding and weighted DC is the average correlation coefficient across the remaining connections.

  • Eigenvector centrality (EC)[14]: fMRI data is written into MNI space at 2mm resolution and spatially smoothed using a 6mm FWHM kernel. The voxel x voxel similarity matrix is calculated by the correlation between every pair of voxel time courses and then thresholded so that only the top 5% of correlations remain. Weighted EC is calculated from the eigenvector corresponding to the largest eigenvalue from an eigenvector decomposition of the resulting similarity. Binarized EC is the first eigenvector of the similarity matrix after setting the non-zero values in the resulting matrix are set to 1.

  • Local functional connectivity density (lFCD)[15]: fMRI data is written into MNI space at 2mm resolution and spatially smoothed using a 6mm FWHM kernel. For each voxel, lFCD corresponds to the number of contiguous voxels that are correlated with the voxel above 0.6 (r>0.6). This is similar to degree centrality, except it only includes the voxels that are directly connected to the seed voxel.

  • 10 intrinsic connectivity networks (ICNs) from dual regression[16]: a template including 10 ICNs from a meta-analysis of resting state and task fMRI data[17] is spatially regressed against the processed fMRI data in MNI space. The resulting time courses are entered into a multiple regression with the voxel data in original space to calculate individual representations of the 10 ICNs. The resulting networks are written into MNI space at 2mm and then spatially smoothed using a 6mm FWHM kernel.

  • Seed correlation analysis (SCA): preprocessed fMRI data is to match template that includes 160 regions of interest defined from a meta-analysis of different task results[18]. A time series is calculated for each region from the mean of all intra-ROI voxel time series. A separate functional connectivity map is calculated per ROI by correlating its time course with the time courses of every other voxel in the brain. Resulting values are Fisher transformed, written into MNI space at 2mm resolution, and then spatially smoothed using a 6mm FWHM kernel.

  • Time series extraction: similar the procedure used for time series analysis, the preprocessed functional data is written into MNI space at 2mm and then time series for the various atlases are extracted by averaging within region voxel time courses. This procedure was used to generate summary time series for the automated anatomic labelling atlas[19], Eickhoff-Zilles atlas[20], Harvard-Oxford atlas[21], Talaraich and Tournoux atlas[22], 200 and 400 regions from the spatially constrained clustering voxel timeseries[23], and 160 ROIs from a meta-analysis of task results[18]. Time series for 10 ICNs were extracted using spatial regression.

References

abcd-options

anat-only: Default with Anatomical Preprocessing Only

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_anat-only.yml

Based on the preprocessing decisions of the default pipeline, this preconfiguration allows you to immediately kick off a run with only anatomical preprocessing selected. This includes:

  • Brain extraction (via AFNI 3dSkullStrip)

  • Tissue segmentation (via FSL FAST)

  • Registration to template (via ANTs/ITK)

preproc: Default without Derivatives

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_preproc.yml

Based on the preprocessing decisions of the default pipeline, this preconfiguration allows you to preprocess all of your data, without launching into calculation of outputs and data derivatives. This includes:

Anatomical:

  • Brain extraction (via AFNI 3dSkullStrip)

  • Tissue segmentation (via FSL FAST)

  • Registration to template (via ANTs/ITK)

Functional:

  • Slice-timing correction

  • Motion estimation & correction

  • Co-registration to structural

  • Nuisance correction & filtering

  • Registration to template (via ANTs/ITK)

fmriprep-options: fmriprep-Options Pipeline

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_fmriprep-options.yml

This pipeline is designed to increase reproducibility with the preprocessing results of the fmriprep pipeline package[24] produced by the Poldrack Lab at Stanford University.

References

  • Esteban, O., Markiewicz, C. J., Blair, R. W., Moodie, C. A., Isik, A. I., Erramuzpe, A., Kent, J. D., Goncalves, M., DuPre, E., Snyder, M., Oya, H., Ghosh, S. S., Wright, J., Durnez, J., Poldrack, R. A., and Gorgolewski, K. J. 2019 January. fMRIPrep: A robust preprocessing pipeline for functional MRI. Nature methods, 16 :1 , pp. 111–116 doi:10.1038/s41592-018-0235-4

  • NiPreps Developers. 2020 September. fMRIPrep: A Robust Preprocessing Pipeline for fMRI Data.

ndmg: Neurodata’s ‘ndmg-f’ Pipeline

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_ndmg.yml

This pipeline is the result of Neurodata’s study to converge upon the intersection of pipeline configuration decisions that maximizes discriminability between participants’ data, drawing from the connectome graphs produced (labeled ‘ndmg_graph’ in the C-PAC output directory). This pipeline invokes a minimal set of preprocessing.

Note, the ‘ndmg_graph’ connectome graph outputs are always produced by C-PAC. This pipeline configuration simply replicates the preprocessing methods described in the paper, linked below.

References

  • Kiar, G., Bridgeford, E. W., Roncal, W. R. G., Consortium for Reliability and Reproducibility (CoRR), Chandrashekhar, V., Mhembere, D., Ryman, S., Zuo, X.-N., Margulies, D. S., Craddock, R. C., Priebe, C. E., Jung, R., Calhoun, V. D., Caffo, B., Burns, R., Milham, M. P., and Vogelstein, J. T. 2018 April. A High-Throughput Pipeline Identifies Robust Connectomes But Troublesome Variability. doi:10.1101/188706

  • NeuroData. NeuroData's MRI to Graphs.

  • NeuroData. 2018 January. ndmg v0.1.0.

rbc-options: ReproBrainChart Options Pipeline

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_rbc-options.yml

RBC-options pipeline was built and integrated in C-PAC based on the Reproducible Brain Charts initiative, which aims to aggregate and harmonize phenotypic and neuroimage data to delineate node mechanisms regarding developmental basis of psychopathology in youth and yield reproducible growth charts of brain development[25].

References

non-human primate

monkey: Default with Monkey Preprocessing

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_monkey.yml

This pipeline is based on the work of Xu et al.[26] and nhp-ABCD-BIDS-pipeline.[27]

References

  • Ramirez, J. S. B., Graham, A. M., Thompson, J. R., Zhu, J. Y., Sturgeon, D., Bagley, J. L., Thomas, E., Papadakis, S., Bah, M., Perrone, A., Earl, E., Miranda-Dominguez, O., Feczko, E., Fombonne, E. J., Amaral, D. G., Nigg, J. T., Sullivan, E. L., and Fair, D. A. 2020 March. Maternal Interleukin-6 Is Associated With Macaque Offspring Amygdala Development and Behavior. Cerebral cortex, 30 :3 , pp. 1573–1585 doi:10.1093/cercor/bhz188

  • Wang, X., Li, X.-H., Cho, J. W., Russ, B. E., Rajamani, N., Omelchenko, A., Ai, L., Korchmaros, A., Sawiak, S., Benn, R. A., Garcia-Saldivar, P., Wang, Z., Kalin, N. H., Schroeder, C. E., Craddock, R. C., Fox, A. S., Evans, A. C., Messinger, A., Milham, M. P., and Xu, T. 2021 July. U-net model for brain extraction: Trained on humans for transfer to non-human primates. Neuroimage, 235 , pp. 118001 doi:10.1016/j.neuroimage.2021.118001

Based on the preprocessing decisions of the default pipeline, this preconfiguration allows you to preprocess all of your macaque data, includes:

Anatomical:

  • Brain extraction (via U-Net)

  • Tissue segmentation (via ANTs-prior based)

  • Registration to template (via ANTs/ITK)

Functional:

  • Despike

  • Slice-timing correction

  • Motion estimation & correction

  • EPI N4 Bias Correction

  • Brain Extraction (Anatomical-refined)

  • Co-registration to structural

  • Nuisance correction & filtering

  • Registration to template (via ANTs/ITK)

  • spatial smoothing

testing

benchmark-ANTS: C-PAC Benchmark with ANTs Registration

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_benchmark-ANTS.yml

The benchmark pipeline has remained mostly unchanged since the project’s inception, and is used at the end of each release cycle to ensure the results of C-PAC’s key outputs have not changed. It is designed to test a wide range of pipeline options. This pipeline is based on registration-to-template using the ANTs/ITK toolset, as this decision impacts many other aspects of the pipeline further downstream.

benchmark-FNIRT: C-PAC Benchmark with FSL FNIRT Registration

Pipeline Configuration YAML: https://github.com/FCP-INDI/C-PAC/blob/main/CPAC/resources/configs/pipeline_config_benchmark-FNIRT.yml

The benchmark pipeline has remained mostly unchanged since the project’s inception, and is used at the end of each release cycle to ensure the results of C-PAC’s key outputs have not changed. It is designed to test a wide range of pipeline options. This pipeline is based on registration-to-template using the FSL FLIRT & FNIRT, as this decision impacts many other aspects of the pipeline further downstream.