DicomFrameSelect

MLModule
genre DICOM
status stable
author Olaf Konrad
package MeVisLab/Standard
dll MLImageFile
definition mlImageFile.def
see also DicomTagModify, DicomTagViewer
keywords DICOM, slice, subtree, timepoint

Purpose

The module DicomFrameSelect allows for a selection of a sub-tree of the input image's DicomTree (DCMTree Overview) at a specified z/t/u position. The module also outputs only this specified slice as an output image.

Usage

The available maximum values are displayed on the GUI and also limit the choice from within the module.

If the image's and the tree's extents do not match, the output image is invalidated or in other words, a DicomTre is only considered valid if the stored image properties match the actual image properties.

Windows

Default Panel

../../../Modules/ML/MLImageFile/mhelp/Images/Screenshots/DicomFrameSelect._default.png

Input Fields

input0

name: input0, type: Image

ML image with a DicomTree.

Output Fields

output0

name: output0, type: Image

Subimage and subtree at the specified z/t/u position.

Parameter Fields

Field Index

Max (zMax): Integer
Max (tMax): Integer
Max (uMax): Integer
Select Tag Scope: Enum
T Pos: Integer
U Pos: Integer
Valid: Bool
Z Pos: Integer

Visible Fields

Select Tag Scope

name: selectTagScope, type: Enum, default: SharedAndSpecificTags

defines the scope of the returned Dicom subtree, which can either be the shared tags with the specified subtags, or only the specified subtags.

Values:

Title Name
Shared And Specific Tags SharedAndSpecificTags
Specific Tags Only SpecificTagsOnly

Z Pos

name: zPos, type: Integer, default: 0, minimum: 0, maximum: :field:`zMax`

The z-slice position for subtree/-image selection.

Limited to the displayed maximum value Max.

T Pos

name: tPos, type: Integer, default: 0, minimum: 0, maximum: :field:`tMax`

The temporal position for subtree/-image selection.

Limited to the displayed maximum value Max.

U Pos

name: uPos, type: Integer, default: 0, minimum: 0, maximum: :field:`uMax`

The user dimension position for subtree/-image selection.

Limited to the displayed maximum value Max.

Max (zMax)

name: zMax, type: Integer, default: 0

Limits the choice for the z-slice.

Max (tMax)

name: tMax, type: Integer, default: 0

Limits the choice for the temporal position.

Max (uMax)

name: uMax, type: Integer, default: 0

Limits the choice for the user dimension position.

Valid

name: valid, type: Bool, default: FALSE

Shows if the operation and therefor the output image is valid.

The output is invalid if the extent of the input image does not match the structure of the frame specific information stored in the image's DICOM tags.