MLDicomModify Overview

MLDicomModify Class Library

The MLDicomModify project contains:

Classes implementing modifications on Dicom Trees:

• DicomModifyBase: A base class managing a modifiable DICOM tree and some virtual functionality to be implemented for specific tag decoders.
• DicomModifyOrdinary: Derived from DicomModifyBase: A concrete modifier for ordinary DICOM tags.
• DicomModifyOtherTagOperations: Derived from DicomModifyBase: A concrete modifier which allows some operations on tag groups in a (cloned) DICOM tree such as removal or modification of all Type 2 or Type 3 tags.
• DicomModifyPrivateAdd: Derived from DicomModifyBase: A concrete modifier to add or replace private DICOM creators and tags.
• DicomModifyPrivateRemove: Derived from DicomModifyBase: A concrete modifier to remove private DICOM creators, tags tags or private (creator) groups.
• DicomModifySequence: Derived from DicomModifyBase: A concrete modifier for sequence DICOM tags.

Collection of DicomModifyBase objects:

• DicomModifyList: A Base object containing a list of objects derived from DicomModifyBase whose modifiers can be applied to a DCMTree.

FieldAddOns allowing DicomTree Tag modifications with DicomModifyBase/DicomModifyList:

• DicomModifyFieldAddOnBase: Derived from DicomModifyList and FieldAddOnBase: Class managing fields for ML modules and instances derived from DicomModifyList to combine field handling and tag modification functionality to modify DCMTree's. This class merges FieldAddOnBase functionality with DicomModifyList with multiple inheritance to make FieldAddOn's directly usable as DCMTree modifiers and to concatenate them to modification pipelines.
• DicomModifyImageTagsFieldAddOn: Derived from DicomModifyFieldAddOnBase: It replaces the image pixel tag in DICOM trees with image data from the image connector and tries to adapt as many as possible related tags accordingly to create mostly DICOM compliant DCMTrees.
• DicomModifyTagsVariousFieldAddOns: Derived from DicomModifyFieldAddOnBase: It composes many typical DicomModifyFieldAddOnBase classes to a single new easy to use one and which provide input/output base fields to concatenate many of them to pipelines.
• DicomModifySubTreeSelectorFieldAddOn: Derived from DicomModifyFieldAddOnBase: It manages fields to select DCMTree sequence or MeVis SMF subtrees which then can be modified by appended DicomModifyTagPlugin instances.
• DicomModifyFieldAddOnList: Tool class to manage multiple DicomModifyFieldAddOns as a list; it is implemented as template allowing to derive from differently typed DicomModifyFieldAddOn classes.

Plugin modules allowing DicomTree modifications:

• DicomModifyTagsPlugin: A concrete class derived from DicomModifyTagsPluginBaseModule which implements an amount of modification algorithms to manipulate DCMTrees making use of DicomModifyOrdinary, DicomModifyOtherTagOperations, DicomModifyPrivateAdd, DicomModifyPrivateRemove, and DicomModifySequence.
• DicomModifyImageTagsPlugin: A concrete ML Module class providing the DicomModifyImageTagsFieldAddOn as modules to modify, adapt or replace image data and image related DICOM tags consistently in DCMTrees.
• A concrete ML module class DicomModifySubTreeSelectorPlugin which allows the selection of DCMTrees inside of Sequence tags or MeVis SMF trees to make it possible that other DicomModifyTagPlugins manipulate them.

ML Module classes:

• DicomModifyCreateTree: ML Module class which creates a DICOM tree, applies connected filters to it, and provides it via a base object at its output.
• DicomModifyMultiFileVolumeExport: ML module class which exports a MultiFileVolume composed of DICOM frames as files with modified DICOM information into a destination directory.
• DicomModifyTreeAndImage: An ML module having different input sources of DCMTrees, connectors for Modifier(lists) to be applied to the DCMTree, an image output (with potentially modified DCMTree) and an output of a reference counted DCMTree.
• ApplyDicomPixelModifiers provides the functionality to modify ML image pixel data according to frame specific DICOM tags such as RGB palette information, rescale/slope, DoseGridScaling etc., because DICOM importers typically do not modify the pixel data.