ciftiTools (version 0.1.6.0)

resample_cifti_wrapper: resample_cifti wrapper

Description

Calls resample_cifti using the original file names listed in the original_fnames argument and the target file names listed in the resamp_fnames argument.

Usage

resample_cifti_wrapper(
  original_fnames,
  resamp_fnames,
  original_res,
  resamp_res,
  surfL_fname = NULL,
  surfR_fname = NULL,
  surfL_target_fname = NULL,
  surfR_target_fname = NULL,
  read_dir = NULL,
  write_dir = NULL,
  wb_path = NULL
)

Arguments

original_fnames

The files to resample. This is a named list where each element's name is a file type label, and each element's value is a file name. Labels must be one of the following: "cortexL", "cortexR", "ROIcortexL", "ROIcortexR", "surfL", or "surfR". If read_dir is not NULL, then all these file names should be relative to read_dir.

resamp_fnames

Where to write the resampled files. This is a named list where each entry's name is a file type label, and each entry's value is a file name indicating where to write the corresponding resampled file. The recognized file type labels are: "cortexL", "cortexR", "ROIcortexL", "ROIcortexR", "validROIcortexL", and "validROIcortexR".

Entry values can be NULL, in which case a default file name will be used: see resample_cifti_default_fname. Default file names will also be used for files that need to be resampled/written but without a corresponding entry in resamp_fnames.

Entries in resamp_fnames will be ignored if they are not needed based on [ROI_]brainstructures. For example, if brainstructures="left", then resamp_fnames$cortexR will be ignored if specified.

The write_dir argument can be used to place each resampled file in the same directory.

original_res

The original resolution of the CIFTI cortical surface(s).

resamp_res

Target resolution for resampling (number of cortical surface vertices per hemisphere).

surfL_fname

(Optional) File path of GIFTI surface geometry file representing the left cortex.

surfR_fname

(Optional) File path of GIFTI surface geometry file representing the right cortex.

surfL_target_fname, surfR_target_fname

(Optional) File path for the resampled GIFTI surface geometry file representing the left/right cortex. If NULL (default),

read_dir

Directory to append to the path of every file being read, e.g. cortexL_original_fname. If NULL (default), do not append any directory to the path.

read_dir must already exist, or an error will be raised.

write_dir

Where should the separated files be placed? NULL (default) will write them to the current working directory.

write_dir must already exist, or an error will occur.

wb_path

(Optional) Path to Connectome Workbench folder or executable. If not provided, should be set with ciftiTools.setOption("wb_path", "path/to/workbench").

Value

The return value of the resample_cifti call

Details

Currently used by read_cifti and resample_cifti.