1gdcmdump(1)                          GDCM                          gdcmdump(1)
2
3
4

NAME

6       gdcmdump - dumps a DICOM file, it will display the structure and values
7       contained in the specified DICOM file.
8

SYNOPSIS

10       gdcmdump [options] dcm_file
11       gdcmdump [options] dcm_directory
12

DESCRIPTION

14       The gdcmdump command line program dumps a DICOM file to the console.
15       For those familiary with dcmdump output, gdcmdump has some minor
16       differences. Namely:
17
18       ยท For Implicit Transfer Syntax gdcmdump will print ?? instead of the
19         dictionary VR
20       gdcmdump has a limited private dictionary that is used to lookup
21       private element whenever possible.

PARAMETERS

23       dcm_file        DICOM input filename
24       dcm_directory   DICOM input directory

OPTIONS

26   OPTIONS
27         -x --xml-dict  generate the XML dict (only private elements for now).
28         -r --recursive recursive (input is a directory)
29         -d --dump      dump value (limited use).
30         -p --print     print value instead of simply dumping (default).
31         -c --color     print in color.
32         -C --csa       print SIEMENS CSA Header (0029,[12]0,SIEMENS CSA HEADER).
33         -P --pdb       print GEMS Protocol Data Block (0025,1b,GEMS_SERS_01).
34         -A --asn1      print encapsulated ASN1 structure >(0400,0520).
35   general options
36         -h   --help
37                print this help text and exit
38
39         -v   --version
40                print version information and exit
41
42         -V   --verbose
43                verbose mode (warning+error).
44
45         -W   --warning
46                warning mode, print warning information
47
48         -E   --error
49                error mode, print error information
50
51         -D   --debug
52                debug mode, print debug information
53   special options
54         -I --ignore-errors   dumps even if file is corrupted (advanced users only, see disclaimers).

Typical usage

56   Printing Implicit Transfer Syntax
57       The VR are not found in the file, thus are presented with a '(??)', and
58       right next to it (if found) the correct VR.
59       Eg.:
60       $ gdcmdump GE_DLX-8-MONO2-PrivateSyntax.dcm
61       # Dicom-File-Format
62       ...
63       (0008,0000) ?? (UL) 434                                           # 4,1 Generic Group Length
64       (0008,0005) ?? (CS) [ISO_IR 100]                                  # 10,1-n Specific Character Set
65       (0008,0008) ?? (CS) [ORIGINAL\PRIMARY\SINGLE PLANE ]              # 30,2-n Image Type
66       (0008,0016) ?? (UI) [1.2.840.10008.5.1.4.1.1.12.1]                # 28,1 SOP Class UID
67       (0008,0018) ?? (UI) [1.2.840.113619.2.16.1.0.906539207.1.24207]   # 42,1 SOP Instance UID
68       (0008,0020) ?? (DA) [19980923]                                    # 8,1 Study Date
69       (0008,0021) ?? (DA) [19980923]                                    # 8,1 Series Date
70       (0008,0022) ?? (DA) [19980923]                                    # 8,1 Acquisition Date
71       (0008,0023) ?? (DA) [19980923]                                    # 8,1 Content Date
72       (0008,0030) ?? (TM) [101229.000]                                  # 10,1 Study Time
73       (0008,0031) ?? (TM) [101229.000]                                  # 10,1 Series Time
74       (0008,0032) ?? (TM) [102653.000]                                  # 10,1 Acquisition Time
75       (0008,0033) ?? (TM) [102653.000]                                  # 10,1 Content Time
76       ...
77   Print Private Attributes
78       GDCM has a limited private dictionary. Whenever possible, it will try
79       to lookup the private data element.
80       $ gdcmdump 012345.002.050.dcm
81       ...
82       (0009,0010) LO [GEMS_IDEN_01]                                     # 12,1 Private Creator
83       (0009,1001) LO [GE_GENESIS_FF ]                                   # 14,1 Full fidelity
84       (0009,1002) SH [MRCV]                                             # 4,1 Suite id
85       (0009,1004) SH [SIGNA ]                                           # 6,1 Product id
86       (0009,1027) SL 985968524                                          # 4,1 Image actual date
87       (0009,1030) SH [19356UMR2 ]                                       # 10,1 Service id
88       (0009,1031) SH [999 ]                                             # 4,1 Mobile location number
89       (0009,10e3) UI [1.2.840.113619.1.1.4.1762386977]                  # 32,1 Equipment UID
90       (0009,10e6) SH [08]                                               # 2,1 Genesis Version - now
91       (0009,10e7) UL 2757786872                                         # 4,1 Exam Record checksum
92       (0009,10e9) SL 985968523                                          # 4,1 Actual series data time stamp
93       ...
94       (0019,0000) UL 1208                                               # 4,1 Generic Group Length
95       (0019,0010) LO [GEMS_ACQU_01]                                     # 12,1 Private Creator
96       (0019,100f) DS [424.399994]                                       # 10,1 Horiz. Frame of ref.
97       (0019,1011) SS 0                                                  # 2,1 Series contrast
98       ...
99       (0019,10e0) DS [0.000000]                                         # 8,1 User data 24 {# DTI Diffusion Dir., release 10.0 & above}
100       (0019,10e2) DS [0.000000]                                         # 8,1 Velocity Encode Scale
101       (0019,10f2) SS 0                                                  # 2,1 Fast phases
102       (0019,10f9) DS [98]                                               # 2,1 Transmit gain
103       ...
104       (0021,0000) UL 372                                                # 4,1 Generic Group Length
105       (0021,0010) LO [GEMS_RELA_01]                                     # 12,1 Private Creator
106       (0021,1003) SS 0                                                  # 2,1 Series from which Prescribed
107       ...
108   SIEMENS CSA Header
109       Using this option it is possible to dump as a readable text what is
110       contained in the private attribute as found in typical SIEMENS MR DICOM
111       file.
112       Eg.:
113       $ gdcmdump --csa MR_SIEMENS_forceLoad29-1010_29-1020.dcm
114       (0029,0010)siemens csa header
115       Image shadow data (0029,xx10)
116
117       0 - 'EchoLinePosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '64      '
118       1 - 'EchoColumnPosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '64      '
119       2 - 'EchoPartitionPosition' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '32      '
120       3 - 'UsedChannelMask' VM 1, VR UL, SyngoDT 9, NoOfItems 6, Data '255     '
121       4 - 'Actual3DImaPartNumber' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data
122       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'
123       6 - 'B_value' VM 1, VR IS, SyngoDT 6, NoOfItems 6, Data '0       '
124       7 - 'Filter1' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data
125       8 - 'Filter2' VM 1, VR IS, SyngoDT 6, NoOfItems 0, Data
126       ...
127   GEMS Protocol Data Block
128       Using this option it is possible to dump as a readable text what is
129       contained in the private attribute as found in typical GEMS MR DICOM
130       file.
131       Protocol Data Block : 0025,xx1b,GEMS_SERS_01
132       $ gdcmdump --pdb GE_MR_0025xx1bProtocolDataBlock.dcm
133       ENTRY "Head First"
134       POSITION "Supine"
135       ANREF "NA"
136       COIL "HEAD"
137       PLANE "OBLIQUE"
138       SEDESCFLAG "1"
139       SEDESC "AX FSE T2"
140       IMODE "2D"
141       PSEQ "FSE-XL"
142       IOPT "FC, EDR, TRF, Fast"
143       PLUG "22"
144       FILTCHOICE "None"
145       BWRT "-1"
146       TRICKSIMG "1"
147       TAG_SPACE "7"
148       TAG_TYPE "None"
149       ...
150   Encapsulated ASN1 Structure
151       This option is mainly used for dumping the ASN1 structure of the
152       encrypted Attribute (0040,0520)
153       $ gdcmdump encrypted.dcm
154       ...
155       (0400,0500) SQ                                                    # u/l,1 Encrypted Attributes Sequence
156         (fffe,e000) na (Item with undefined length)
157           (0400,0510) UI [1.2.840.10008.1.2]                            # 18,1 Encrypted Content Transfer Syntax UID
158           (0400,0520) OB 30\82\03\ba\06\09\2a\86\48\55\04\08\13         # 958,1 Encrypted Content
159         (fffe,e00d)
160       (fffe,e0dd)
161       ...
162       $ gdcmdump --asn1 encrypted.dcm
163           0:d=0  hl=4 l= 954 cons: SEQUENCE
164           4:d=1  hl=2 l=   9 prim:  OBJECT            :pkcs7-envelopedData
165          15:d=1  hl=4 l= 939 cons:  cont [ 0 ]
166          19:d=2  hl=4 l= 935 cons:   SEQUENCE
167          23:d=3  hl=2 l=   1 prim:    INTEGER           :00
168          26:d=3  hl=4 l= 366 cons:    SET
169          30:d=4  hl=4 l= 362 cons:     SEQUENCE
170          34:d=5  hl=2 l=   1 prim:      INTEGER           :00
171          37:d=5  hl=2 l=  82 cons:      SEQUENCE
172          39:d=6  hl=2 l=  69 cons:       SEQUENCE
173          41:d=7  hl=2 l=  11 cons:        SET
174          43:d=8  hl=2 l=   9 cons:         SEQUENCE
175          45:d=9  hl=2 l=   3 prim:          OBJECT            :countryName
176          50:d=9  hl=2 l=   2 prim:          PRINTABLESTRING   :AU
177          54:d=7  hl=2 l=  19 cons:        SET
178          56:d=8  hl=2 l=  17 cons:         SEQUENCE
179          58:d=9  hl=2 l=   3 prim:          OBJECT            :stateOrProvinceName
180          63:d=9  hl=2 l=  10 prim:          PRINTABLESTRING   :Some-State
181          75:d=7  hl=2 l=  33 cons:        SET
182          77:d=8  hl=2 l=  31 cons:         SEQUENCE
183          79:d=9  hl=2 l=   3 prim:          OBJECT            :organizationName
184          84:d=9  hl=2 l=  24 prim:          PRINTABLESTRING   :Internet Widgits Pty Ltd
185         110:d=6  hl=2 l=   9 prim:       INTEGER           :AC966D88787A51B4
186         121:d=5  hl=2 l=  13 cons:      SEQUENCE
187         123:d=6  hl=2 l=   9 prim:       OBJECT            :rsaEncryption
188         134:d=6  hl=2 l=   0 prim:       NULL
189         136:d=5  hl=4 l= 256 prim:      OCTET STRING      [HEX DUMP]:822368070285AD756C962ECB973514B291F946...
190         396:d=3  hl=4 l= 558 cons:    SEQUENCE
191         400:d=4  hl=2 l=   9 prim:     OBJECT            :pkcs7-data
192         411:d=4  hl=2 l=  29 cons:     SEQUENCE
193         413:d=5  hl=2 l=   9 prim:      OBJECT            :aes-256-cbc
194         424:d=5  hl=2 l=  16 prim:      OCTET STRING      [HEX DUMP]:3B49AFE71749F2BFF1519EBAEA95A393
195         442:d=4  hl=4 l= 512 prim:     cont [ 0 ]

SEE ALSO

197       gdcmdump(1), gdcmraw(1), gdcmanon(1)
199       Copyright (c) 2006-2010 Mathieu Malaterre
200
201
202
203Version 2.0.16                  Tue Jul 26 2011                    gdcmdump(1)
Impressum