Skip to content

reconst_fw_noddi

Sub-workflow that runs both RECONST/NODDI and RECONST/FREEWATER modules by handling the conditional execution of the diffusivity priors. Single-value diffusivity priors can be specified as input to this subworkflow. If not specified, the subworkflow will compute the priors automatically. They can then be averaged using the average_diff_priors argument of this workflow.

Keywords : multi-shell, freewater, noddi, diffusion

Components : reconst/noddi, reconst/freewater, reconst/diffusivitypriors, reconst/meandiffusivitypriors, reconst/dtimetrics, utils_options


TypeDescriptionMandatoryPattern
dwi_bval_bvecfileThe input channel containing the DWI, BVAL, and BVEC files.

Structure : tuple val(meta), path(dwi), path(bval), path(bvec)
  • meta [map] Metadata map.
  • dwi [file] DWI file.
  • bval [file] B-values file.
  • bvec [file] B-vectors file.
True*.\{dwi,bval,bvec\}
brain_maskfileThe input channel containing the brain mask file (e.g. b0_mask).

Structure : tuple val(meta), path(brain_mask)
  • meta [map] Metadata map.
  • brain_mask [file] Brain mask file.
True*.nii.gz
fa_ad_rd_mdfileThe input channel containing DTI metrics (FA, AD, RD, MD). Not used when supplying custom diffusivity priors.

Structure : tuple val(meta), path(fa), path(ad), path(rd), path(md)
  • meta [map] Metadata map.
  • fa [file] Fractional anisotropy file.
  • ad [file] Axial diffusivity file.
  • rd [file] Radial diffusivity file.
  • md [file] Mean diffusivity file.
False*.nii.gz
diffusivitiesMapThe input channel containing custom diffusivity priors to use for NODDI and FreeWater models. If not provided, the diffusivity priors will be computed automatically. Can be subject-bound (i.e. different values per subject), a single-value for all subjects, or empty to compute them automatically. IMPORTANT: all priors must be provided the same way, meaning that if one prior is subject-bound, all others must be subject-bound as well (same for single-value or empty). para_diff: channel.empty(), // Example of empty to compute automatically iso_diff: channel.value(0.003), // Example of single-value for all subjects perp_diff_min: channel.of( // Example of subject-bound values tuple([ id:‘subj1’ ], 0.0001), tuple([ id:‘subj2’ ], 0.00015) ), perp_diff_max: channel.of( tuple([ id:‘subj1’ ], 0.0007), tuple([ id:‘subj2’ ], 0.00065) ) ]

Structure: `[
False
optionsMapMap of options for the subworkflow.

  • run_noddi (boolean) [Default: False]
    If ‘true’, the NODDI reconstruction will be performed.
  • run_freewater (boolean) [Default: False]
    If ‘true’, the FreeWater correction will be performed.
  • average_diff_priors (boolean) [Default: False]
    If ‘true’, the diffusivity priors computed from the RECONST/DIFFUSIVITYPRIORS module will be averaged across all subjects. (Recommended)
  • silence_single_shell_warnings (boolean) [Default: False]
    If ‘true’, the workflow will silence warnings about single-shell data (e.g. when filtering subjects for NODDI).
False

TypeDescriptionMandatoryPattern
noddi_dirfileNifti file main direction.

Structure : tuple val(meta), path(dir)
  • meta [map] Metadata map.
  • dir [file] NODDI main direction file.
False*__fit_dir.nii.gz
noddi_isovffileNifti file for isotropic volume fraction.

Structure : tuple val(meta), path(isovf)
  • meta [map] Metadata map.
  • isovf [file] NODDI isotropic volume fraction file.
False*__isovf.nii.gz
noddi_icvffileNifti file for intracellular volume fraction.

Structure : tuple val(meta), path(icvf)
  • meta [map] Metadata map.
  • icvf [file] NODDI intracellular volume fraction file.
False*__icvf.nii.gz
noddi_ecvffileNifti file for Extra-Cellular Volume Fraction.

Structure : tuple val(meta), path(ecvf)
  • meta [map] Metadata map.
  • ecvf [file] NODDI extra-cellular volume fraction file.
False*__ecvf.nii.gz
noddi_odifileNifti file for Orientation Dispersion Index.

Structure : tuple val(meta), path(odi)
  • meta [map] Metadata map.
  • odi [file] NODDI orientation dispersion index file.
False*__odi.nii.gz
fw_dwifileFree Water corrected DWI Nifti file.

Structure : tuple val(meta), path(fw_dwi)
  • meta [map] Metadata map.
  • fw_dwi [file] Free water corrected DWI file.
False*__dwi_fw_corrected.nii.gz
fw_dirfileFree Water corrected main direction Nifti file.

Structure : tuple val(meta), path(fw_dir)
  • meta [map] Metadata map.
  • fw_dir [file] Free water corrected main direction file.
False*__dir.nii.gz
fw_fibervolumefileFree Water corrected fiber volume Nifti file.

Structure : tuple val(meta), path(fw_fibvolume)
  • meta [map] Metadata map.
  • fw_fibvolume [file] Free water corrected fiber volume file.
False*__fibervolume.nii.gz
fw_fwffileFree Water corrected Free Water Fraction Nifti file.

Structure : tuple val(meta), path(fw_fwf)
  • meta [map] Metadata map.
  • fw_fwf [file] Free water fraction file.
False*__fwf.nii.gz
fw_nrmsefileFree Water correction NRMSE Nifti file.

Structure : tuple val(meta), path(fw_nrmse)
  • meta [map] Metadata map.
  • fw_nrmse [file] Free water correction NRMSE file.
False*__nrmse.nii.gz
fw_dti_tensorfileFree Water corrected DTI tensor Nifti file.

Structure : tuple val(meta), path(fw_dti_tensor)
  • meta [map] Metadata map.
  • fw_dti_tensor [file] Free water corrected DTI tensor file.
False*__tensor.nii.gz
fw_dti_mdfileFree Water corrected DTI Mean Diffusivity Nifti file.

Structure : tuple val(meta), path(fw_dti_md)
  • meta [map] Metadata map.
  • fw_dti_md [file] Free water corrected DTI mean diffusivity file.
False*__md.nii.gz
fw_dti_rdfileFree Water corrected DTI Radial Diffusivity Nifti file.

Structure : tuple val(meta), path(fw_dti_rd)
  • meta [map] Metadata map.
  • fw_dti_rd [file] Free water corrected DTI radial diffusivity file.
False*__rd.nii.gz
fw_dti_adfileFree Water corrected DTI Axial Diffusivity Nifti file.

Structure : tuple val(meta), path(fw_dti_ad)
  • meta [map] Metadata map.
  • fw_dti_ad [file] Free water corrected DTI axial diffusivity file.
False*__ad.nii.gz
fw_dti_fafileFree Water corrected DTI Fractional Anisotropy Nifti file.

Structure : tuple val(meta), path(fw_dti_fa)
  • meta [map] Metadata map.
  • fw_dti_fa [file] Free water corrected DTI fractional anisotropy file.
False*__fa.nii.gz
fw_dti_rgbfileFree Water corrected DTI RGB Nifti file.

Structure : tuple val(meta), path(fw_dti_rgb)
  • meta [map] Metadata map.
  • fw_dti_rgb [file] Free water corrected DTI RGB file.
False*__rgb.nii.gz
fw_dti_peaksfileFree Water corrected DTI Peaks Nifti file.

Structure : tuple val(meta), path(fw_dti_peaks)
  • meta [map] Metadata map.
  • fw_dti_peaks [file] Free water corrected DTI peaks file.
False*__evec_v1.nii.gz
fw_dti_evecsfileFree Water corrected DTI Eigenvectors Nifti file.

Structure : tuple val(meta), path(fw_dti_evecs)
  • meta [map] Metadata map.
  • fw_dti_evecs [file] Free water corrected DTI eigenvectors file.
False*__evecs.nii.gz
fw_dti_evalsfileFree Water corrected DTI Eigenvalues Nifti file.

Structure : tuple val(meta), path(fw_dti_evals)
  • meta [map] Metadata map.
  • fw_dti_evals [file] Free water corrected DTI eigenvalues file.
False*__evals.nii.gz
fw_dti_residualfileFree Water corrected DTI Residuals Nifti file.

Structure : tuple val(meta), path(fw_dti_residual)
  • meta [map] Metadata map.
  • fw_dti_residual [file] Free water corrected DTI residuals file.
False*__residual.nii.gz
fw_dti_gafileFree Water corrected DTI Geodesic Anisotropy Nifti file.

Structure : tuple val(meta), path(fw_dti_ga)
  • meta [map] Metadata map.
  • fw_dti_ga [file] Free water corrected DTI geodesic anisotropy file.
False*__ga.nii.gz
fw_dti_modefileFree Water corrected DTI Mode Nifti file.

Structure : tuple val(meta), path(fw_dti_mode)
  • meta [map] Metadata map.
  • fw_dti_mode [file] Free water corrected DTI mode file.
False*__mode.nii.gz
fw_dti_normfileFree Water corrected DTI Norm Nifti file.

Structure : tuple val(meta), path(fw_dti_norm)
  • meta [map] Metadata map.
  • fw_dti_norm [file] Free water corrected DTI norm file.
False*__norm.nii.gz
versionsfileFile containing software versions

Structure : tuple path(versions)
  • versions [file] Versions YAML file.
Trueversions.yml


Last updated : 2026-03-17