XNAT 1.7 DicomEdit 4, DicomEdit 6, and Mizer 18 October, 2017

DicomEdit 4 & 6 A software library that transforms DICOM objects based on a scripted list of commands Scripts are written by users in a small custom language defined by DicomEdit Scripts can be general purpose, providing a general anonymization, or customized to handle unique requirements posed by a specific project or data source.

Mizer and DicomEdit frameworks DicomEdit 6 is very similar to DicomEdit 4, but with some notable differences: Requires version declaration: version "6.1" Handles sequences and private tags, including function to remove all private tags Some changes in core syntax Both are supported in 1.7 Programmatically the implementation is abstracted through the Mizer service

DicomEdit 6 basics The following slides show some of the basics of the DicomEdit 6 language.

Statements Comment Assignment Deletion // All after the slashes is ignored. Assignment (0010,0010) := “My Patient Name” Deletion - (0010,1030) // delete Patient Weight

Statements (continued) Conditionals // mirror Java’s ternary if-then-else operator (0020,0011) = "1" ? (0008,103E) := "Series One" : “Default Series Descrip” // match regular expressions (0020,0011) ~ “[1-5]” ? – (0080,103E) Conditional Operators ‘=‘ equal ‘!=‘ not equal ‘~’ matches ‘!~’ not matches

String literals, delimited by quotes Identifiers Elements String literals, delimited by quotes “Desmond^Jones” Identifiers patientName := “Molly^Jones” // variable names removeAllPrivateTags // single word operations patientName := concatenate[(0010,0020), (0010,0030)] Tagpath Represents a DICOM attribute or a set of attributes May represent a location or the value at that location

Tagpaths Simple Tag Tag Wildcards (0010,0010) // Patient Name Attribute Tag Wildcards ‘X’ matches any hex digit, ‘@’ even, and ‘#’ odd (50X@,3000) // matches all 3000 elements in the even groups between 5000 and 50FE (Curve Data)

Simple Sequence Tagpath Tagpaths: Sequence Simple Sequence Tagpath // match the coding scheme name in the first item in the coding scheme identification sequence. (0008,0110)[0](0008,0115) Sequence Wildcards [* ? +] DICOM elements can be nested arbitrarily deep. * / (0010,0010) // address patient name anywhere it appears + / (00100010) // address patient name at least one level deep

Tagpaths: Private Tags Private data elements do not have unique tags Their unique location within a particular object is determined by its ‘private creator id’ tag. (0019,{SIEMENS MR HEADER}0C) correctly addresses the Diffusion b-value attribute regardless of where it is mapped in any particular object.

How To: Remove all private tags // remove all private tags – this is a common requirement // Why make it hard? removeAllPrivateTags

How To: White list certain private tags // record white listed to variables Diffusion-b-value := (0019,{SIEMENS MR HEADER}09) // remove all private tags removeAllPrivateTags // restore the variables (0019,{SIEMENS MR HEADER}09) := Diffusion-b-value DicomEdit How To: White list certain private tags

How To: Remove a tag nested in a sequence // retain patient name at the top level but remove it from sequences in which it is embedded - + / (0010, 0010)

Explore further Built-in functions Custom functions Externally injected variables Home page: https://wiki.xnat.org/xnat-tools/dicomedit Language Reference: https://wiki.xnat.org/xnat-tools/dicomedit/dicomedit-6-1-language-reference