qsiprep.workflows.fieldmap.drbuddi module

Correcting Susceptibility Distortion with DRBUDDI

DRBUDDI is part of the TORTOISE software that estimates and corrects susceptibility distortion. It has multiple modes of operation

  1. Use $b=0$ images to estimate distortion.

  2. Perform a multimodal registration using $b=0$ images and FA images. This requires two DWI series with opposite phase encoding directions

  3. Either (1) or (2) but a t2w image is used as well

qsiprep.workflows.fieldmap.drbuddi.init_drbuddi_wf(scan_groups, t2w_sdc)[source]

This workflow implements the heuristics to choose a SDC strategy.

(Source code)

Parameters:

  • scan_groups (dict of distortion groupings) – Inputs configuration for distortion correction

  • t2w_sdc (bool) – Should a T2w image be included in the DRBUDDI run?

Inputs:

  • dwi_file (str) – Path to a motion/eddy corrected DWI file (in LPS+)

  • bval_file (str) – Corresponding bval file for dwi_file

  • bvec_file (str) – Corresponding bvec file for dwi_file (in LPS+)

  • original_files (list) – List of the original BIDS file for each image in dwi_file

  • t1_brain – T1w image, brain-masked

  • t2_brain – T2w image, brain masked

Outputs:

  • b0_ref – An unwarped b0 reference

  • b0_mask – The corresponding new mask after unwarping

  • sdc_warps – The deformation fields to unwarp the susceptibility distortions in each image in dwi_file