AverageSiemensDTI

MLModule
genre DTIImageProcessing
author Jan Klein
package FMEwork/Release
dll MLDTI
definition MLDTI.def
keywords DTI, Diffusion, Tensor, Siemens, average, trace, NEX

Purpose

The module AverageSiemensDTI has two options:

  1. It allows for an automatic averaging of several DTI acquisitions (repetitions). All images with a corresponding gradient are averaged. Furthermore, B0 images are averaged. As a consequence, the final output data will consist out of one B0 image, followed by all gradient images which are stored in the t-dimension.
  2. It allows for computing the trace image, i.e., all diffusion weighted images are averaged to one trace image. In addition, all B0 images are averaged within one single B0 image. As a consequence, the final output data will consist out of one B0 image, followed by one trace image which is stored in the t-dimension.

The module may only be used with Siemens DTI data where gradients are stored in DICOM tags.

Usage

Connect input data an select desired option.

Details

Note that you have to use the DecodeVendorSpecificDicomTags module before the Bootstrap module!

Otherwise it will not work. Use DicomTagViewer, enable private tags, and have a look at tag 0021,10xx if the gradient information are stored. B0 images are indicated by \B, gradients by corresponding numbers. Alternatively you may use the DTIInfo module.

Windows

Default Panel

../../../Projects/MLDiffusionMRI/Modules/MLDTI/mhelp/Images/Screenshots/AverageSiemensDTI._default.png

Input Fields

input0

name: input0, type: Image

Siemens DTI data with gradients stored at DICOM tags. At least two repetitions of the measurement have to be stored in the data if you want to use the option which averages your repetitions.

Output Fields

output0

name: output0, type: Image

Output image data corresponding to the selected option (average repetitions or trace).

Parameter Fields

Visible Fields

Output average of multiple acquisitions

name: optimalImage, type: Bool, default: TRUE

If enabled, all repetitions are averaged.

Output trace image

name: calculateTrace, type: Bool, default: FALSE

If enabled, all gradient images are averaged into one trace image.

Hidden Fields

sampleSize

name: sampleSize, type: Integer, default: 3

not relevant for this instantiation of the module (only useful for module Bootstrap)

numberOfB

name: numberOfB, type: Integer, default: 1

not relevant for this instantiation of the module (only useful for module Bootstrap)

newSeed

name: newSeed, type: Trigger

not relevant for this instantiation of the module (only useful for module Bootstrap)

seedValue

name: seedValue, type: Integer, default: 0

not relevant for this instantiation of the module (only useful for module Bootstrap)

careUnusalDataSorting

name: careUnusalDataSorting, type: Bool, default: TRUE

If this field is set to True AND if 'B' or 'C' or ' ' or '' are at the end of the gradient string, then the number of gradients is reduced by one. Usually, this happens only for wrongly implemented DICOM standards. Thus, this value is set to True as default.