Linux Certif

Toute la documentation sur la certification Linux LPI

gdcminfo

NAME

gdcminfo - .TH "gdcminfo" 1 "Thu Sep 16 2010" "Version 2.0.15" "GDCM"

NAME

gdcminfo - .SH "SYNOPSIS"

 
 gdcminfo [options] file-in
 

DESCRIPTION

The gdcminfo command line program takes as input a DICOM file, or a directory and process it to extract meta- information about the DICOM file processed.

PARAMETERS

 
 file-in   DICOM input filename
 

OPTIONS

OPTIONS

 
   -r --recursive          recursive.
   -d --check-deflated     check if file is proper deflated syntax.
      --resources-path     Resources path.
      --md5sum             Compute md5sum of Pixel Data attribute value.
      --check-compression  check the encapsulated stream compression (lossless/lossy).
 

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
 

environment variable

GDCM_RESOURCES_PATH path pointing to resources files (Part3.xml, ...)

Simple usage

gdcmData

Using data from gdcmData:

 
 $ gdcminfo gdcmData/012345.002.050.dcm
 

 
 MediaStorage is 1.2.840.10008.5.1.4.1.1.4 [MR Image Storage]
 NumberOfDimensions: 2
 Dimensions: (256,256)
 Origin: (-85,21.6,108.7)
 Spacing: (0.664062,0.664062,1.5)
 DirectionCosines: (1,0,0,0,0,-1)
 Rescale Intercept/Slope: (0,1)
 SamplesPerPixel    :1
 BitsAllocated      :16
 BitsStored         :16
 HighBit            :15
 PixelRepresentation:1
 Orientation Label: CORONAL
 

Davie Clunie datasets:

Using data from David Clunie datasets:

 
 $ gdcminfo BRTUM001.dcm
 

 
 MediaStorage is 1.2.840.10008.5.1.4.1.1.4.1 [Enhanced MR Image Storage]
 NumberOfDimensions: 3
 Dimensions: (256,256,15)
 Origin: (40,-105,105)
 Spacing: (0.820312,0.820312,6)
 DirectionCosines: (0,1,0,0,0,-1)
 Rescale Intercept/Slope: (0,1)
 SamplesPerPixel    :1
 BitsAllocated      :16
 BitsStored         :16
 HighBit            :15
 PixelRepresentation:1
 Orientation Label: SAGITTAL
 

Checking the md5sum of the Pixel Data

After compressing a DICOM file (see gdcmconv) using a lossless compression algorithm, it is fairly easy to compare the two files for differences at DICOM attribute level. However one operation is slightly easier to do: how to make sure the compression was actually lossless ? In this case one could use the --md5sum operation.

Take an uncompressed DICOM image file:

 
 $ gdcminfo --md5sum SIEMENS_ImageLocationUN.dcm
 

The tool return: 0621954acd5815e0b4f7b65fcc6506b1

Now compress this file:

 
 $ gdcmconv --jpegls SIEMENS_ImageLocationUN.dcm lossless_compressed.dcm
 

and then check again the md5sum:

 
 $ gdcminfo --md5sum lossless_compressed.dcm
 

The tool return: 0621954acd5815e0b4f7b65fcc6506b1

Checking if Pixel Data is lossless

In come environment one wish to check whether or not the DICOM file is lossless or not. It is fairly easy to do that in most cases. Only in two occasion this is not clear from the sole DICOM Attribute. When the Transfer Syntax is JPEG 2000 Image Compression (1.2.840.10008.1.2.4.91) and when the Transfer Syntax is JPEG-LS Lossy (Near-Lossless) Image Compression (1.2.840.10008.1.2.4.81).

In this case, the only solution is to open the Pixel Data element, read the specific JPEG header and check whether or not the JPEG transformation was lossless or not:

 
 $ gdcminfo --check-compression gdcmData/MAROTECH_CT_JP2Lossy.dcm
 

The tool returns: 'Encapsulated Stream was found to be: lossy'

SEE ALSO

gdcmdump(1), gdcmraw(1), gdcmconv(1)

COPYRIGHT

Copyright (c) 2006-2010 Mathieu Malaterre