.TH "gdcminfo" 1 "Tue Feb 5 2013" "Version 2.2.0" "GDCM" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdcminfo \- Display meta info about the input DICOM file\&. 
.SH "SYNOPSIS"
.PP
.PP
.nf
gdcminfo [options] file-in
.fi
.PP
.SH "DESCRIPTION"
.PP
The \fBgdcminfo\fP command line program takes as input a DICOM file, or a directory and process it to extract meta- information about the DICOM file processed\&.
.SH "PARAMETERS"
.PP
.PP
.nf
file-in   DICOM input filename
.fi
.PP
.SH "options"
.PP
.SS "options"
.PP
.nf
  -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).
.fi
.PP
.SS "general options"
.PP
.nf
  -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
.fi
.PP
.SS "environment variable"
GDCM_RESOURCES_PATH path pointing to resources files (Part3\&.xml, \&.\&.\&.)
.SH "Simple usage"
.PP
.SS "gdcmData"
Using data from gdcmData:
.PP
.PP
.nf
$ gdcminfo gdcmData/012345.002.050.dcm
.fi
.PP
.PP
.PP
.nf
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
.fi
.PP
.SS "Davie Clunie datasets:"
Using data from David Clunie datasets:
.PP
.PP
.nf
$ gdcminfo BRTUM001.dcm
.fi
.PP
.PP
.PP
.nf
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
.fi
.PP
.SS "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\&.
.PP
Take an uncompressed DICOM image file:
.PP
.PP
.nf
$ gdcminfo --md5sum SIEMENS_ImageLocationUN.dcm
.fi
.PP
.PP
The tool return: 0621954acd5815e0b4f7b65fcc6506b1
.PP
Now compress this file:
.PP
.PP
.nf
$ gdcmconv --jpegls SIEMENS_ImageLocationUN.dcm lossless_compressed.dcm
.fi
.PP
.PP
and then check again the md5sum:
.PP
.PP
.nf
$ gdcminfo --md5sum lossless_compressed.dcm
.fi
.PP
.PP
The tool return: 0621954acd5815e0b4f7b65fcc6506b1
.SS "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)\&.
.PP
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:
.PP
.PP
.nf
$ gdcminfo --check-compression gdcmData/MAROTECH_CT_JP2Lossy.dcm
.fi
.PP
.PP
The tool returns: 'Encapsulated Stream was found to be: lossy'
.SH "SEE ALSO"
.PP
\fBgdcmdump\fP(1), \fBgdcmraw\fP(1), \fBgdcmconv\fP(1)
.SH "COPYRIGHT"
.PP
Copyright (c) 2006-2011 Mathieu Malaterre