image_convertdwi
Small utility module to perform data type conversion on dwi images. The new datatype can be specified using the task.ext.datatype parameter. Using strides parameters, it will convert the dwi as well as the bval and bvec files to ensure they remain consistent with the converted image.
Keywords : image, dwi, convert, datatype
Inputs
Section titled “Inputs”Input 1
Section titled “Input 1”Format : tuple val(meta), path(image), path(bval), path(bvec)
| Type | Description | Mandatory | Pattern | |
|---|---|---|---|---|
| meta | map | Groovy Map containing sample information e.g. [ id:'sample1', single_end:false ] | True | |
| image | file | Image to convert. | True | *.nii.gz |
| bval | file | B-values in FSL format [DWI]. | True | *.bval |
| bvec | file | B-values in FSL format [DWI]. | True | *.bvec |
Outputs
Section titled “Outputs”Format : tuple val(meta), path(*.nii.gz)
| Type | Description | Mandatory | Pattern | |
|---|---|---|---|---|
| meta | map | Groovy Map containing sample information e.g. [ id:'sample1', single_end:false ] | True | |
| *.nii.gz | file | Image converted into the specified datatype. | True | *.nii.gz |
Format : tuple val(meta), path(*.bval)
| Type | Description | Mandatory | Pattern | |
|---|---|---|---|---|
| meta | map | Groovy Map containing sample information e.g. [ id:'test', single_end:false ] | True | |
| *.bval | file | B-values corrected in FSL format | True | *.bval |
Format : tuple val(meta), path(*.bvec)
| Type | Description | Mandatory | Pattern | |
|---|---|---|---|---|
| meta | map | Groovy Map containing sample information e.g. [ id:'test', single_end:false ] | True | |
| *.bvec | file | B-vectors corrected in FSL format | True | *.bvec |
versions
Section titled “versions”Format : path(versions.yml)
| Type | Description | Mandatory | Pattern | |
|---|---|---|---|---|
| versions.yml | file | File containing software versions | True | versions.yml |
Arguments (see process.ext)
Section titled “Arguments (see process.ext)”| Type | Description | Default | Choices | |
|---|---|---|---|---|
| datatype | string | Data type to convert the image to. This should be a valid data type supported by MRtrix3, such as “float32”, “int16”, etc. If not specified, the module will fail. | “ | |
| suffix | string | Optional suffix to add to the output filename before the datatype. If not specified, the output filename will only include the datatype as a suffix. | “ | |
| strides | string | Optional strides to specify the memory layout of the output image. This should be a space-separated string of integers, such as “1 2 3 4”. If not specified, the default memory layout will be used. | “ |
| Description | DOI | |
|---|---|---|
| MRtrix3 | MRtrix3 is a software package for various types of diffusion imaging data, including diffusion-weighted, diffusion-tensor, and q-ball imaging. | 10.1016/j.neuroimage.2019.116137 |
Authors
Section titled “Authors”Last updated : 2026-05-12