1GDCMINFO(1) DICOM Manipulation. GDCMINFO(1)
2
3
4
6 gdcminfo - Display meta info about the input DICOM file.
7
9 gdcminfo [options] [file-in/dir-in...]
10
12 The gdcminfo command line program takes as input a DICOM file, or a
13 directory and process it to extract meta-information about the DICOM
14 file(s) processed.
15
17 file-in/dir-in DICOM input filename/dirname
18
20 specific options
21 -r --recursive recursive traversal of an input directory
22 -d --check-deflated check if file is proper deflated syntax.
23 --resources-path Resources path.
24 --md5sum Compute md5sum of Pixel Data attribute value.
25 --check-compression check the encapsulated stream compression (lossless/lossy).
26 --force-rescale force rescale.
27 --force-spacing force spacing.
28 --mosaic dump image information of MOSAIC.
29
30 general options
31 -h --help
32 print this help text and exit
33
34 -v --version
35 print version information and exit
36
37 -V --verbose
38 verbose mode (warning+error).
39
40 -W --warning
41 warning mode, print warning information
42
43 -E --error
44 error mode, print error information
45
46 -D --debug
47 debug mode, print debug information
48
49 environment variable
50 GDCM_RESOURCES_PATH path pointing to resources files (Part3.xml, ...)
51
53 gdcmData
54 Using data from gdcmData:
55
56 $ gdcminfo gdcmData/012345.002.050.dcm
57
58 MediaStorage is 1.2.840.10008.5.1.4.1.1.4 [MR Image Storage]
59 NumberOfDimensions: 2
60 Dimensions: (256,256)
61 Origin: (-85,21.6,108.7)
62 Spacing: (0.664062,0.664062,1.5)
63 DirectionCosines: (1,0,0,0,0,-1)
64 Rescale Intercept/Slope: (0,1)
65 SamplesPerPixel :1
66 BitsAllocated :16
67 BitsStored :16
68 HighBit :15
69 PixelRepresentation:1
70 Orientation Label: CORONAL
71
72 Davie Clunie datasets:
73 Using data from David Clunie datasets:
74
75 $ gdcminfo BRTUM001.dcm
76
77 MediaStorage is 1.2.840.10008.5.1.4.1.1.4.1 [Enhanced MR Image Storage]
78 NumberOfDimensions: 3
79 Dimensions: (256,256,15)
80 Origin: (40,-105,105)
81 Spacing: (0.820312,0.820312,6)
82 DirectionCosines: (0,1,0,0,0,-1)
83 Rescale Intercept/Slope: (0,1)
84 SamplesPerPixel :1
85 BitsAllocated :16
86 BitsStored :16
87 HighBit :15
88 PixelRepresentation:1
89 Orientation Label: SAGITTAL
90
91 Checking the md5sum of the Pixel Data
92 After compressing a DICOM file (see gdcmconv) using a lossless
93 compression algorithm, it is fairly easy to compare the two files for
94 differences at DICOM attribute level. However one operation is slightly
95 easier to do: how to make sure the compression was actually lossless ?
96 In this case one could use the –md5sum operation.
97
98 Take an uncompressed DICOM image file:
99
100 $ gdcminfo --md5sum SIEMENS_ImageLocationUN.dcm
101
102 The tool return: 0621954acd5815e0b4f7b65fcc6506b1
103
104 Now compress this file:
105
106 $ gdcmconv --jpegls SIEMENS_ImageLocationUN.dcm lossless_compressed.dcm
107
108 and then check again the md5sum:
109
110 $ gdcminfo --md5sum lossless_compressed.dcm
111
112 The tool return: 0621954acd5815e0b4f7b65fcc6506b1
113
114 Checking if Pixel Data is lossless
115 In some environment one wish to check whether or not the DICOM file is
116 lossless. It is fairly easy to do that in most cases. Only on two
117 occasions this is not clear from the sole DICOM Attributes. When the
118 Transfer Syntax is JPEG 2000 Image Compression (1.2.840.10008.1.2.4.91)
119 and when the Transfer Syntax is JPEG-LS Lossy (Near-Lossless) Image
120 Compression (1.2.840.10008.1.2.4.81).
121
122 In this case, the only solution is to open the Pixel Data element, read
123 the specific JPEG header and check whether or not the JPEG
124 transformation was lossless or not:
125
126 $ gdcminfo --check-compression gdcmData/MAROTECH_CT_JP2Lossy.dcm
127
128 The tool returns: “Encapsulated Stream was found to be: lossy”
129
130 Pay attention that this tool also checks the Image Lossy Compression
131 attribute (0028,2110). This means --check-compression will also returns
132 a value of lossy if a predecessor was found to be lossy compressed.
133
135 Dump the image as if MOSAIC. If the input is really MOSAIC image, then
136 print the information of the true underlying MOSAIC volume.
137
138 $ gdcminfo --mosaic siemens_mosaic.dcm
139
141 gdcmdump(1), gdcmraw(1), gdcmconv(1)
142
144 Mathieu Malaterre
145 Main developer
146
148 Copyright © 2006, 2011 Mathieu Malaterre
149
150
151
152GDCM 3.0.12 04/02/2022 GDCMINFO(1)