xcp_d.utils.bids.collect_surface_data

xcp_d.utils.bids.collect_surface_data(layout, participant_label)[source]

Collect surface files from preprocessed derivatives.

This function will try to collect fsLR-space, 32k-resolution surface files first. If these standard-space surface files aren’t available, it will default to native T1w-space files.

Parameters:

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

  • participant_label (str) – Subject ID.

Returns:

  • mesh_available (bool) – True if surface mesh files (pial and smoothwm) were found. False if they were not.

  • shape_available (bool) – True if surface shape files (curv, sulc, and thickness) were found. False if they were not.

  • standard_space_mesh (bool) – True if standard-space (fsLR) surface mesh files were found. False if they were not.

  • surface_files (dict) – Dictionary of surface file identifiers and their paths. If the surface files weren’t found, then the paths will be Nones.