reconst_freewater

Run freewater modelling pipeline using AMICO from DWI data.

Keywords : Diffusion MRI, Freewater, Microstructure modeling

---

Inputs

Input 1

Format : tuple val(meta), path(dwi), path(bval), path(bvec), path(mask), path(kernels)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
dwi	file	Nifti DWI file acquired with a freewater compatible protocol (single-shell or multi-shell).	True	*.{nii,nii.gz}
bval	file	B-values in FSL format.	True	*.bval
bvec	file	B-vectors in FSL format.	True	*.bvec
mask	file	Nifti brain mask.	True	*mask.{nii,nii.gz}
kernels	directory	Folder containg kernels.	True	kernels

---

Outputs

dwi_fw_corrected

Format : tuple val(meta), path(*__dwi_fw_corrected.nii.gz)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
*__dwi_fw_corrected.nii.gz	file	Nifti file freewater corrected DWI.	True	*__dwi_fw_corrected.{nii,nii.gz}

dir

Format : tuple val(meta), path(*__dir.nii.gz)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
*__dir.nii.gz	file	Nifti file main direction.	True	*__dir.{nii,nii.gz}

fibervolume

Format : tuple val(meta), path(*__FiberVolume.nii.gz)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
*__FiberVolume.nii.gz	file	Nifti file for fiber volume.	True	*__FiberVolume.{nii,nii.gz}

fw

Format : tuple val(meta), path(*__FW.nii.gz)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
*__FW.nii.gz	file	Nifti file for freewater (isotropic volume).	True	*__FIT_FW.{nii,nii.gz}

nrmse

Format : tuple val(meta), path(*__NRMSE.nii.gz)

	Type	Description	Mandatory	Pattern
meta	map	Groovy Map containing sample information e.g. [ id:'test', single_end:false ]	True
*__NRMSE.nii.gz	file	Nifti file for nrmse.	True	*__NRMSE.{nii,nii.gz}

kernels

Format : path(kernels)

	Type	Description	Mandatory	Pattern
kernels	directory	Folder containing kernels.	True	kernels

versions

Format : path(versions.yml)

	Type	Description	Mandatory	Pattern
versions.yml	file	File containing software versions.	True	versions.yml

---

Tools

	Description	DOI
scilpy	The Sherbrooke Connectivity Imaging Lab (SCIL) Python dMRI processing toolbox.
Freewater	Free water elimination and mapping from diffusion MRI.	10.1002/mrm.22055
AMICO	Accelerated Microstructure Imaging via Convex Optimization.	10.1016/j.neuroimage.2014.10.026

---

Authors

• @karanphil

---

Last updated : 2025-10-30