Running the HCP pipeline
Contents
Running the HCP pipeline#
Prerequisites
For an overview on how to prepare data and run the HCP preprocessing steps, see Overview of steps for running the HCP pipeline. For an overview of mapping the input data into HCP folder structer via the mapping file see HCP Pipeline Mapping in QuNex.
HCP minimal preprocessing pipeline implements the processing steps prepared by the Human Connectome Project. The pipelines are described in detail in Glasser et al. (2013), whereas the general approach is presented in Glasser et al. (2016). QuNex includes a modified branch of the HCP that enables additional flexibility and application of the pipelines on wider array of datasets that would not meet HCP minimum acquisition requirements.
Overall the preprocessing is organized in a series of steps that are run consecutively. For full details, please consult Glasser et al. (2013). Here is a brief list of the pipelines and the corresponding QuNex commands:
General information on running the HCP pipeline
Information on general settings, folder structure, running commands, and logging.
Processing of structural images#
PreFreeSurfer [command:
hcp_pre_freesurfer
]Processes the T1w and T2w images and aligns them to the MNI atlas space.
FreeSurfer [command:
hcp_freesurfer
]Runs optimized FreeSurfer processing for tissue segmentation, reconstruction of cortical mantle and identification of major cortical and subcortical anatomical structures.
PostFreeSurfer [command:
hcp_post_freesurfer
]Computes additional surface files, converts them to CIFTI format, and generates myelin maps.
Longitudinal FreeSurfer [command:
hcp_long_freesurfer
]Runs the longitudinal HCP FreeSurfer pipeline.
Longitudinal Post FreeSurfer [command:
hcp_long_post_freesurfer
]Runs the longitudinal HCP FreeSurfer pipeline.
Processing of BOLD images#
fMRIVolume [command:
hcp_fmri_volume
]Processes BOLD images and registers them to MNI atlas space.
fMRISurface [command:
hcp_fmri_surface
]Maps the BOLD signal to a combined surface and volume, grayordinate representation stored in CIFTI format.
Processing of Diffusion Weighted images (DWI)#
Diffusion [command:
hcp_diffusion
]Computes motion correction, distortion correction, eddy current correction and registration to native T1 space. Assumes presence of phase-encoding reversed DWI pairs. After this step data are ready for FSL's dtifit, bedpostx and probtrackx.
-
Computes motion correction, distortion correction, eddy current correction and registration to native T1 space. Works with 'legacy' data that is not phase-encoding reversed. It accepts standard field maps or runs if no field maps are present (results will be worse). After this step legacy data are ready for FSL's dtifit, bedpostx and probtrackx.
Each of the steps is run using the specified qunex
command. The processing is optimized so that multiple processes can be run in parallel, and the processing can be distributed over multiple nodes on a supercomputer cluster (please refer to General information on running the HCP pipeline How to run each of the steps is described in detail along with the list of relevant parameters that can or need to be specified on the respective pages.
In addition to the HCP minimal preprocessing pipeline, the QuNex suite also implements the following HCP pipelines.
ICAFix [commands:
hcp_icafix
,hcp_post_fix
,hcp_reapply_fix
]Prepares and runs ICA-based classifier for identifying signal vs. noise components of fMRI data.
MSMAll [commands:
hcp_msmall
,hcp_dedrift_and_resample
]Runs multi-modal surface-based functional alignment of individual sessions' cortical data to group template.
Task fMRI analyses [command:
hcp_task_fmri_analysis
]Runs GLM analyses on HCP preprocessed data.