This function computes subject-level principal components (PCs) from fMRI data and performs a group-level PCA for dimension reduction, designed for cortical surface fMRI data in BIDS format.
gen_groupPC(
bids_path,
subj_list,
n.comp = 30,
ncore = 1,
npc = 85,
iter_std = 5,
brainstructures = c("left", "right"),
verbose = TRUE
)A numeric matrix containing the group-level principal components, with dimensions determined by the number of retained components (n.comp) and the concatenated data across all subjects.
A character string specifying the root directory of the BIDS-formatted dataset.
A named list generated from create_group_list containing fMRI file paths for each subject.
An integer specifying the number of components to retain during group-level PCA. Default is 30.
An integer specifying the number of cores to use for parallel processing. Default is 1.
An integer specifying the number of components to retain during subject-level PCA. Default is 85.
An integer specifying the number of iterative standardization steps to apply to fMRI data. Default is 5.
A character vector specifying the brain structures to include in the analysis. Options are "left" (left cortex), "right" (right cortex), and/or "subcortical" (subcortex and cerebellum). Can also be "all" (obtain all three brain structures). Default is c("left", "right").
A logical value indicating whether to print convergence information during execution. Default is TRUE.
NOTE: This function requires the ciftiTools package to be installed, and set up the path to the Connectome Workbench folder by ciftiTools.setOption(). See the package ciftiTools documentation for more information.