xcp_d.utils.bids.collect_run_data

xcp_d.utils.bids.collect_run_data(layout, input_type, bold_file, cifti, primary_anat)[source]

Collect data associated with a given BOLD file.

Parameters:
  • layout (bids.layout.BIDSLayout) – BIDSLayout indexing the ingested (e.g., fMRIPrep-format) derivatives.

  • input_type ({“fmriprep”, “dcan”, “hcp”, “nibabies”}) – The format of the incoming preprocessed BIDS derivatives. DCAN- and HCP-format derivatives will automatically be converted to a more BIDS-compliant format. fMRIPrep and Nibabies derivatives are assumed to be roughly equivalent in terms of file organization and naming.

  • bold_file (str) – Path to the BOLD file.

  • cifti (bool) – Post-process surface data (CIFTIs) instead of volumetric data (NIFTIs). This parameter is overridden when DCAN- or HCP-format data are provided. Default is False. Whether to collect files associated with a CIFTI image (True) or a NIFTI (False).

  • primary_anat ({“T1w”, “T2w”}) – The anatomical modality to use for the anat-to-native transform.

Returns:

run_data – A dictionary of file types (e.g., “confounds”) and associated filenames.

Return type:

dict