read confound files

read in fmriprep confound tables for one or more subjects

# S3 method for bids_project
read_confounds(
  x,
  subid = ".*",
  task = ".*",
  session = ".*",
  cvars = DEFAULT_CVARS,
  npcs = -1,
  perc_var = -1,
  nest = TRUE
)

Arguments

subid	(optional) subid regex selector
task	(optional) task regex selector
cvars	the names of the confound variables to select. If missing, defaults to a set defined by constant DEFAULT_CVARS.
npcs	perform pca reduction on confound matrix and reduce to npcs dimensions
perc_var	perform pca reduction on confound matrix and retain perc_var percent of total (selected) confound variance
nest	nest confound tables by subject/sesssion/run