Purpose

DicomModifyCreateTree builds a new DCMTree and passes it to the output connector where it is provided as a MultiFileVolumeListRefCounted Base object. If no input DCMTree is given from any input then a new tree is created from the scratch, otherwise a deep-copy form the given input is created. In all cases a tag name dictionary is set.

Windows

Default Panel

../../../Projects/DICOM/MLDicomModify/Modules/mhelp/Images/Screenshots/DicomModifyCreateTree._default.png

Input Fields

input0

name: input0, type: Image

This image input is used as source for copying the DCMTree if Input Selector is Image Connector.

inputBase

name: inputBase, type: MLBase

The Base input is used as source for copying the DCMTree if Input Selector is Base Connector.

inputDicomModifier

name: inputDicomModifier, type: MLBase

This is an input connector where DicomModifyList objects can be connected which can be used to modify the DCMTree before it is passed to the outputDicomTree output.

Output Fields

outputDicomTree

name: outputDicomTree, type: MLBase

This is a Base connector providing a DicomTreeRefCounted object.

Parameter Fields

Field Index

#Volumes: Integer Tag Dump: String
Annotate: Bool Tag Dump Size: Integer
Dump Private Tag Values: Bool True File Name: String
File Name: String warnDirectoriesOnBrowsing: Bool
Filter: String warnNonExistingFileOnBrowsing: Bool
InIdx: Integer  
Input Selector: Enum  
Num shown binary bytes: Integer  

Visible Fields

File Name

name: unresolvedFileName, type: String, deprecated name: unresolvedDcmInputFileName

If a loading operation from disk is selected as input in the Input Selector then the file name from which the DICOM tree shall be loaded is specified here. Otherwise this field is insensitive.

True File Name

name: absoluteFileName, type: String, persistent: no, deprecated name: dcmInputFileName

If File is selected as input in the Input Selector field then the file name from which the DCMTree shall be loaded is specified here. Otherwise this field is insensitive.

Input Selector

name: inputSelector, type: Enum, default: ImageConnector

Selects from which connector a MultFileVolume(List) or DCMTree shall be loaded or whether it shall be loaded from a file.

Values:

Title Name Description
Image Connector ImageConnector Selects the image connector as source for the DCMTree to be copied.
Base Connector BaseConnector Selects the Base connector as source for the DCMTree to be copied.
File File Selects a file as source for the DCMTree to be copied.

InIdx

name: inputVolumeIndex, type: Integer, default: 0

If the Base input is selected as source and a MultiFileVolumeList is connected then one of multiple volumes can be selected with this field. The number of available volumes is shown in the #Volumes field. Otherwise this should always be 0.

#Volumes

name: numVolumes, type: Integer, persistent: no

This read-only field shows the number of available volumes. For most inputs this will be 0 if no DCMTree is available, 1 if there is any, or any other number for a lists of volumes at inputBase if a MultiFileVolumeListRefCounted base object is connected and selected in Input Selector.

Tag Dump Size

name: tagDumpSize, type: Integer, default: 10000

Maximum number of characters shown in the Tag Dump field. Too large values can degrade performance when viewing the tag list.

Dump Private Tag Values

name: dumpPrivateTagValues, type: Bool, default: FALSE

If enabled then values of private tags are decoded if decoders are available.

Num shown binary bytes

name: numShownBinaryEntries, type: Integer, default: 8

Number of shown entries of binary tags.

Annotate

name: annotate, type: Bool, default: FALSE

If enabled then tags are annotated with further descriptive information such as possible types (1=Mandatory, 1C=Conditionally Mandatory, 2=Mandatory, may have zero or one item, 2C=Conditionally Mandatory, but may be empty, 3=Optional) and possible meanings of the tag. Note that no context analysis is performed for that information and therefore all possible and perhaps redundant meanings are shown.

Filter

name: regExLineFilter, type: String

If not empty then the regular expression is used to filter all lines of the tag dump. Examples: .* // Matches all paths.

.*logo.* // Matches anything containing ‘logo’ (case sensitive)

.*[lL][oO][gG][oO].* // Matches anything containing ‘logo’ (case insensitive)

.*.[jJ][pP][gG] // Matches anything ending with .jpg where jpg is case insenstive.

.*.JPG|.*.jpg // Matches all paths ending with either ‘.jpg’ or with ‘.JPG’.

.*d.* // Matches all paths containing at least one digit.

.*[[:digit:]].* // Same as above.

.*[[:xdigit:]].* // Matches all paths containing at least one hexadecimal digit.

.*l.* // Matches all paths containing at least one lower case character.

.*[[:lower:]].* // Same as above.

.*u.* // Matches all paths containing at least one upper case character.

.*[[:upper:]].* // Same as above.

.*s.* // Matches all paths containing at least one white space character.

.*[[:space:]].* // Same as above.

.*[[:blank:]].* // Matches all paths containing at least one non-line-separating whitespace.

.*[[:word:]].* // Matches all paths containing at least one word charcater (alphanumeric characters plus the underscore).

.*[[:w:]].* // Same as above.

.*[[:graph:]].* // Matches all paths containing at least one graphical charcater.

.*[5-7].* // Matches all paths containing at least one of the digits 5, 6 or 7.

Tag Dump

name: tagDump, type: String, persistent: no

Shows the DICOM tag list of currently selected volume (the dump will be clamped if the tag list is too large).

Hidden Fields

warnNonExistingFileOnBrowsing

name: warnNonExistingFileOnBrowsing, type: Bool, default: TRUE

warnDirectoriesOnBrowsing

name: warnDirectoriesOnBrowsing, type: Bool, default: TRUE