1GDCMINFO(1)                   DICOM Manipulation.                  GDCMINFO(1)
2
3
4

NAME

6       gdcminfo - Display meta info about the input DICOM file.
7

SYNOPSIS

9       gdcminfo [options] [file-in/dir-in...]
10

DESCRIPTION

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

PARAMETERS

17           file-in/dir-in   DICOM input filename/dirname
18

OPTIONS

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

SIMPLE USAGE

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

CHECKING IMAGE AS IF MOSAIC

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

SEE ALSO

141       gdcmdump(1), gdcmraw(1), gdcmconv(1)
142

AUTHOR

144       Mathieu Malaterre
145           Main developer
146

148       Copyright © 2006, 2011 Mathieu Malaterre
149
150
151
152GDCM 3.0.21                       02/06/2023                       GDCMINFO(1)
Impressum