xcp_d.workflows.bold.cifti module

Workflows for post-processing CIFTI-format BOLD data.

xcp_d.workflows.bold.cifti.init_postprocess_cifti_wf(bold_file, head_radius, run_data, t1w_available, t2w_available, n_runs, has_multiple_runs, mem_gb, name='cifti_postprocess_wf')[source]

Organize the cifti processing workflow.

Workflow Graph
../_images/xcp_d-workflows-bold-cifti-1.png

(Source code, png, svg, pdf)

Parameters:

  • bold_file

  • head_radius (float or “auto”) – Radius of the head, in millimeters, for framewise displacement calculation.

    xcp_d’s default head radius is 50. The recommended value for infants is 35. A value of ‘auto’ is also supported, in which case the brain radius is estimated from the preprocessed brain mask. This will already be estimated before this workflow.

  • run_data (dict)

  • t1w_available

  • t2w_available

  • n_runs – Number of runs being postprocessed by XCP-D. This is just used for the boilerplate, as this workflow only posprocesses one run.

  • has_multiple_runs – Whether there are multiple runs for this task or not. Interacts with the output_run_wise_correlations parameter.

  • mem_gb (dict) – Dictionary of memory allocations with keys 'bold' and 'volume'.

  • name (str, optional) – Name of the workflow. This is used for working directories and workflow graphs. Default is “cifti_postprocess_wf”.

Inputs:

  • bold_file – CIFTI file

  • boldref (str) – Path to the BOLD reference file associated with the target BOLD run. This comes from the preprocessing derivatives.

  • t1w – Preprocessed T1w image, warped to standard space. Fed from the subject workflow.

  • t2w – Preprocessed T2w image, warped to standard space. Fed from the subject workflow.

  • motion_file

  • motion_json

  • dummy_scans (int or “auto”) – Number of volumes to remove from the beginning of each run. If set to ‘auto’, xcp_d will extract non-steady-state volume indices from the preprocessing derivatives’ confounds file.

Outputs:

  • name_source (str) – Path to the file that will be used as the source_file for derivatives. This is generally the preprocessed BOLD file. This file does not need to exist (e.g., in the case of a concatenated version of the filename).

  • preprocessed_bold (str) – The preprocessed BOLD file, after dummy scan removal.

  • motion_file

  • temporal_mask (str) – Temporal mask; all values above fd_thresh set to 1. This is a TSV file with one column: ‘framewise_displacement’.

  • denoised_interpolated_bold (str) – Path to the censored, denoised, interpolated, and filtered BOLD file. This file is the result of denoising the censored preprocessed BOLD data, followed by cubic spline interpolation and band-pass filtering.

    This output should not be used for analysis. It is primarily for DCAN QC plots.

  • censored_denoised_bold (str) – Path to the censored, denoised, interpolated, filtered, and re-censored BOLD file. This file is the result of denoising the censored preprocessed BOLD data, followed by cubic spline interpolation, band-pass filtering, and re-censoring.

    This output is the primary derivative for analysis.

  • boldref (str) – Path to the BOLD reference file associated with the target BOLD run. This comes from the preprocessing derivatives.

  • bold_mask

  • timeseries (list of str) – List of paths to atlas-specific time series TSV files. These time series are produced from the censored_denoised_bold outputs.

  • timeseries_ciftis (list of str) – List of paths to atlas-specific time series CIFTI (ptseries) files. These time series are produced from the censored_denoised_bold outputs.

References