gdcmdump (1) Linux Manual Page

NAME

gdcmdump – .TH "gdcmdump" 1 "Fri Oct 29 2010" "Version 2.0.16" "GDCM"

NAME

gdcmdump – .SH "SYNOPSIS"

gdcmdump[options] dcm_file
    gdcmdump[options] dcm_directory

DESCRIPTION

The gdcmdump command line program dumps a DICOM file to the console. For those familiary with dcmdump output, gdcmdump has some minor differences. Namely:

*

For Implicit Transfer Syntax gdcmdump will print ?? instead of the dictionary VR

gdcmdump has a limited private dictionary that is used to lookup private element whenever possible.

PARAMETERS

dcm_file        DICOM input filename
dcm_directory   DICOM input directory

OPTIONS

OPTIONS

-x –xml-dict generate the XML dict (only private elements for now).
-r –recursive recursive (input is a directory)
-d –dump dump value (limited use).
-p –print print value instead of simply dumping (default).
-c –color print in color.
-C –csa print SIEMENS CSA Header (0029,[12]0,SIEMENS CSA HEADER).
-P –pdb print GEMS Protocol Data Block (0025,1b,GEMS_SERS_01).
-A –asn1 print encapsulated ASN1 structure >(0400,0520).

general options

– h– help
print this help text and exit –
v– version
print version information and exit –
V– verbose
verbose
mode(warning + error)
.-
W– warning
warning mode,
print warning information
– E– error
error mode,
print error information
– D– debug
debug mode,
print debug information

special options

  -I --ignore-errors   dumps even if file is corrupted (advanced users only, see disclaimers).

Typical usage

Printing Implicit Transfer Syntax

The VR are not found in the file, thus are presented with a ‘(??)’, and right next to it (if found) the correct VR.

Eg.:

$ gdcmdump GE_DLX-8-MONO2-PrivateSyntax.dcm

#Dicom – File – Format
…(0008, 0000) ? ? (UL)434 #4, 1 Generic Group Length(0008, 0005) ? ? (CS)[ISO_IR 100] #10, 1 – n Specific Character Set(0008, 0008) ? ? (CS)[ORIGINAL\PRIMARY\SINGLE PLANE] #30, 2 – n Image Type(0008, 0016) ? ? (UI)[1.2.840.10008.5.1.4.1.1.12.1] #28, 1 SOP Class UID(0008, 0018) ? ? (UI)[1.2.840.113619.2.16.1.0.906539207.1.24207] #42, 1 SOP Instance UID(0008, 0020) ? ? (DA)[19980923] #8, 1 Study Date(0008, 0021) ? ? (DA)[19980923] #8, 1 Series Date(0008, 0022) ? ? (DA)[19980923] #8, 1 Acquisition Date(0008, 0023) ? ? (DA)[19980923] #8, 1 Content Date(0008, 0030) ? ? (TM)[101229.000] #10, 1 Study Time(0008, 0031) ? ? (TM)[101229.000] #10, 1 Series Time(0008, 0032) ? ? (TM)[102653.000] #10, 1 Acquisition Time(0008, 0033) ? ? (TM)[102653.000] #10, 1 Content Time…

Print Private Attributes

GDCM has a limited private dictionary. Whenever possible, it will try to lookup the private data element.

$ gdcmdump 012345.002.050.dcm

…(0009, 0010) LO[GEMS_IDEN_01] #12, 1 Private Creator(0009, 1001) LO[GE_GENESIS_FF] #14, 1 Full fidelity(0009, 1002) SH[MRCV] #4, 1 Suite id(0009, 1004) SH[SIGNA] #6, 1 Product id(0009, 1027) SL 985968524 #4, 1 Image actual date(0009, 1030) SH[19356UMR2] #10, 1 Service id(0009, 1031) SH[999] #4, 1 Mobile location number(0009, 10e3) UI[1.2.840.113619.1.1.4.1762386977] #32, 1 Equipment UID(0009, 10e6) SH[08] #2, 1 Genesis Version – now(0009, 10e7) UL 2757786872 #4, 1 Exam Record checksum(0009, 10e9) SL 985968523 #4, 1 Actual series data time stamp…(0019, 0000) UL 1208 #4, 1 Generic Group Length(0019, 0010) LO[GEMS_ACQU_01] #12, 1 Private Creator(0019, 100f) DS[424.399994] #10, 1 Horiz.Frame of ref.(0019, 1011)SS 0 #2, 1 Series contrast…(0019, 10e0) DS[0.000000] #8, 1 User data 24 {#DTI Diffusion Dir., release 10.0 & above}(0019, 10e2)DS[0.000000] #8, 1 Velocity Encode Scale(0019, 10f2) SS 0 #2, 1 Fast phases(0019, 10f9) DS[98] #2, 1 Transmit gain…(0021, 0000) UL 372 #4, 1 Generic Group Length(0021, 0010) LO[GEMS_RELA_01] #12, 1 Private Creator(0021, 1003) SS 0 #2, 1 Series from which Prescribed…

SIEMENS CSA Header

Using this option it is possible to dump as a readable text what is contained in the private attribute as found in typical SIEMENS MR DICOM file.

Eg.:

$ gdcmdump --csa MR_SIEMENS_forceLoad29-1010_29-1020.dcm

(0029,0010)siemens csa header
Image shadow data (0029,xx10)
0 - 'EchoLinePosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '64      '
1 - 'EchoColumnPosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '64      '
2 - 'EchoPartitionPosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '32      '
3 - 'UsedChannelMask' VM 1, VR UL, SyngoDT 9, NoOfItems 6, Data '255     '
4 - 'Actual3DImaPartNumber' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data 
5 - 'ICE_Dims' VM 1, VR LO, SyngoDT 19, NoOfItems 6, Data 'X_1_1_1_1_1_1_31_1_1_1_1_19'
6 - 'B_value' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '0       '
7 - 'Filter1' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data 
8 - 'Filter2' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data 
...

GEMS Protocol Data Block

Using this option it is possible to dump as a readable text what is contained in the private attribute as found in typical GEMS MR DICOM file.

Protocol Data Block : 0025,xx1b,GEMS_SERS_01

$ gdcmdump --pdb GE_MR_0025xx1bProtocolDataBlock.dcm

ENTRY "Head First"
POSITION "Supine"
ANREF "NA"
COIL "HEAD"
PLANE "OBLIQUE"
SEDESCFLAG "1"
SEDESC "AX FSE T2"
IMODE "2D"
PSEQ "FSE-XL"
IOPT "FC, EDR, TRF, Fast"
PLUG "22"
FILTCHOICE "None"
BWRT "-1"
TRICKSIMG "1"
TAG_SPACE "7"
TAG_TYPE "None"
...

Encapsulated ASN1 Structure

This option is mainly used for dumping the ASN1 structure of the encrypted Attribute (0040,0520)

$ gdcmdump encrypted.dcm

...

(0400,0500) SQ                                                    # u/l,1 Encrypted Attributes Sequence

  (fffe,e000) na (Item with undefined length)

    (0400,0510) UI [1.2.840.10008.1.2]                            # 18,1 Encrypted Content Transfer Syntax UID

    (0400,0520) OB 30\82a