Skip to content

fodf

Module: reconst/fodf

Perform FODF reconstruction and compute FODF metrics from a dwi volume for a selected number of shells. Note that multiple choices of FODF reconstruction method are available through the method argument. The single-shell single-tissue (ssst) method is performed by selecting only one shell (task.ext.fodf_shells) and choosing the ssst method (task.ext.method). The multi-shell single-tissue (msst) method (default) is performed by selecting multiple shells (task.ext.fodf_shells) and choosing the ssst method (task.ext.method). Both ssst and msst are expected to output only WM FODF. The multi-shell multi-tissue (msmt) method is performed by selecting multiple shells (task.ext.fodf_shells) and choosing the msmt method (task.ext.method). The msmt method is expected to output WM FODF, GM FODF and CSF FODF, along with volume fraction (vf) maps. In every case, chosen FODF metrics are outputed.

Inputs

TypeDescriptionMandatoryPattern
metamapGroovy Map containing sample information e.g. [ id:'test', single_end:false ]true
dwifileNifti DWI volume to reconstruct FODF from.*.{nii,nii.gz}
bvalfileB-values in FSL format.*.bval
bvecfileB-vectors in FSL format.*.bvec
maskfileB0 mask.*.{nii,nii.gz}
fafileFA map.*.{nii,nii.gz}
mdfileMD map.*.{nii,nii.gz}
wm_frffileFiber Response Function (FRF) for the white matter (WM). In the case of single-shell method, this should be the only input FRF. In the case of multi-shell method, gm_frf and csf_frf are also mandatory.*.txt
gm_frffileFiber Response Function (FRF) for the grey matter (GM). Only use with multi-shell method, along with wm_frf and csf_frf.*.txt
csf_frffileFiber Response Function (FRF) for the CSF. Only use with multi-shell method, along with wm_frf and gm_frf.*.txt

Outputs

TypeDescriptionPattern
metamapGroovy Map containing sample information e.g. [ id:'test', single_end:false ]
fodffileFODF map.*fodf.nii.gz
wm_fodffileWM FODF map.*wm_fodf.nii.gz
gm_fodffileGM FODF map.*gm_fodf.nii.gz
csf_fodffileCSF FODF map.*csf_fodf.nii.gz
vffileVolume fraction map.*vf.nii.gz
vf_rgbfileVolume fraction map in rgb.*vf_rgb.nii.gz
peaksfilePeaks file.*peaks.nii.gz
peak_valuesfilePeak values file.*peak_values.nii.gz
peak_indicesfilePeak indices file.*peak_indices.nii.gz
afd_maxfileMaximum Apparent Fiber Density (AFDmax) map.*afd_max.nii.gz
afd_totalfileTotal Apparent Fiber Density (AFDtotal) map.*afd_total.nii.gz
afd_sumfileSum of all Apparent Fiber Density (Afdsum) map.*afd_sum.nii.gz
nufofileNumber of Fiber Orientation (NuFO) map.*nufo.nii.gz
vent_maskfileVentricule mask estimated from an MD and FA threshold.*ventricles_mask.nii.gz
versionsfileFile containing software versionsversions.yml

Tools

DescriptionHomepageDOI
scilpyThe Sherbrooke Connectivity Imaging Lab (SCIL) Python dMRI processing toolbox.https://github.com/scilus/scilpy.git

Authors

@gagnonanthony, @karanphil