DicomImportTagFilter

MLModule

genre	DICOM
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	DicomImport
definition	DicomImport.def
see also	DicomImport
keywords	Read, Load

Purpose

The module DicomImportTagFilter allows for filtering DICOM objects for a specific tag before the image data is imported in a connected DicomImport module.

This is more efficient compared to filtering after the import process. Tag values can be compared with several comparison operators. To combine multiple tag comparison, DicomImportTagFilter modules can be chained.

Usage

Connect this module to the input slot of a DicomImport module or a DicomImportBooleanOperationFilter module. Add the filter tag as a tag number (gggg, eeee) in DICOM Tag or as tag name in DICOM Tag Name. The other field is updated automatically. Choose your comparison mode for the tag value drop-down Compare Mode. Enter your compare value in Search String. If the entered value does not match the VR of the tag, this field is marked red. If you want to allow DICOM objects to be imported that do not contain the tag, check Ignore filter if tag is missing.

Details

If a DicomImportTagFilter module contains invalid data, it is ignored during the import process.

Tips

You can chain several DicomImportTagFilter modules by connecting their input and output fields. This is equivalent to using a DicomImportBooleanOperationFilter module with an AND operation and connecting the DicomImportTagFilter modules to its inputs.

Windows

Default Panel

Input Fields

inputPlugin

name: inputPlugin, type: DicomImportFilterBase(MLBase)

Output Fields

outputPlugin

name: outputPlugin, type: DicomImportFilterBase(MLBase)

Parameter Fields

Field Index

Compare Mode: Enum

DICOM Tag: String

DICOM Tag Name: String

Ignore filter if tag is missing: Bool

Search String: String

searchValid: Bool

tagValid: Bool

Visible Fields

DICOM Tag

name: dicomTag, type: String

DICOM Tag Name

name: dicomTagName, type: String

Search String

name: searchString, type: String

Compare Mode

name: compareMode, type: Enum, default: ==

Values:

Title	Name
==	==
!=	!=
<=	<=
<	<
>=	>=
>	>
regex	regex
!regex	!regex

Ignore filter if tag is missing

name: passIfMissing, type: Bool, default: FALSE

Hidden Fields

tagValid

name: tagValid, type: Bool, persistent: no

searchValid

name: searchValid, type: Bool, persistent: no