Skip to content

eddy

Module: preproc/eddy

Apply Eddy (and Topup if already run)

Keywords : distorsion correction, preproc, eddy


Inputs

TypeDescriptionMandatoryPattern
metamapGroovy Map containing sample information e.g. [ id:'test', single_end:false ]true
dwifileDWI Nifti image*.{nii,nii.gz}
bvalfileB-values in FSL format [DWI].*.bval
bvecfileB-values in FSL format [DWI].*.bvec
rev_dwifileDWI Nifti image [rev-DWI].*.{nii,nii.gz}
rev_bvalfileB-values in FSL format [rev-DWI].*.bval
rev_bvecfileB-vectors in FSL format [rev-DWI].*.bvec
corrected_b0sfileNifti volume b0 corrected*__corrected_b0s.nii.gz
topup_fieldcoeffileNifti volume - topup field to correct for distorsion*_fieldcoef.nii.gz
topup_movpartfileText file - topup movpart*__movpar.txt

Outputs

TypeDescriptionPattern
metamapGroovy Map containing sample information e.g. [ id:'test', single_end:false ]
dwi_correctedfileNifti volume - DWI corrected*__dwi_corrected.nii.gz
bval_correctedfileB-values corrected in FSL format*__bval_eddy
bvec_correctedfileB-vectors corrected in FSL format*__dwi_eddy_corrected.bvec
b0_maskfileNifti volume - Mask for b0 corrected*__b0_bet_mask.nii.gz
dwi_eddy_mqcfile.gif file containing quality control image for the eddy process. Made for use in MultiQC report.*_dwi_eddy_mqc.gif
rev_dwi_eddy_mqcfile.gif file containing quality control image for the eddy process for the rev_dwi. Made for use in MultiQC report.*_rev_dwi_eddy_mqc.gif
versionsfileFile containing software versionsversions.yml

Arguments (see process.ext)

TypeDescriptionDefaultChoices
slice_drop_flagbooleanIf set, will activate eddy’s outlier correction, which includes slice drop correction.False
bet_topup_before_eddy_ffloatFractional intensity threshold for BET before running topup0.16
prefix_topupstringPrefix for the topup output.topup_results
b0_thr_extract_b0intThreshold under which b-values are considered to be b0s.10
encodingstringEncoding direction of the forward DWI.yx, y or z
readoutfloatTotal readout time from the DICOM metadata.0.062
dilate_b0_mask_prelim_brain_extractionintNumber of times to repeatedly apply the filter.5
eddy_cmdstringCommand to run Eddy.eddy_cpu
bet_prelim_ffloatFractional intensity threshold for BET if TOPUP has not been run.0.16
extra_argsstringExtra arguments for Eddy.
run_qcbooleanRun QC for Eddy.False

Tools

DescriptionDOI
scilpyThe Sherbrooke Connectivity Imaging Lab (SCIL) Python dMRI processing toolbox.
MRtrix3Toolbox for image processing, analysis and visualisation of dMRI.
FSLFSL Toolbox and Scilpy Toolbox

Authors

arnaudbore


Last updated : 2025-07-15