gdcmscanner - Man Page

gdcmscanner [options] directory

The gdcmscanner is a command line tool to quickly extract value from a set of DICOM attribute in a DICOM File-Set​.

  -d --dir       DICOM directory
  -t --tag %d,%d DICOM tag(s) to look for
  -k --keyword %s           DICOM keyword(s) to look for
  -P --private-tag %d,%d,%s DICOM private tag(s) to look for

  -p --print      Print output​.
  -r --recursive  Recursively descend directory​.
     --strict     Use strict parser (faster but less tolerant with bogus DICOM files)​.
     --table      Use Table output​.

  -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

In order to display all the value for Patient Name (0010,0010) in the directory name gdcmData, simply do:

$ gdcmscanner -t 10,10 -d gdcmData -p

For private tag simply do:

$ gdcmscanner -P "0029,60,SIEMENS MEDCOM HEADER2" -d gdcmData -p

In order to display as CSV (see dicom3tools/dctable) all the values for SOP Instance / Study Instance / Series Instance UID(s) in the directory name gdcmData, simply do:

$ gdcmscanner -k SOPInstanceUID -k StudyInstanceUID -k SeriesInstanceUID -d gdcmData -p --table

Because gdcmscanner does not support progress, you have to wait until all files are traversed to see any results​. This is quite cumbersome, on UNIX this can be worked around with the following trick:

$ find gdcmData -type d -exec gdcmscanner -t 10,10 -d {} -p ';'

So all directory are locally traversed (no child directory are recursively traversed), which means results comes out much faster​.

dctable(1), gdcmdump(1), gdcmraw(1)

Mathieu Malaterre

Copyright © 2006, 2011 Mathieu Malaterre