gdcmscanner man page

gdcmscanner — Scan a directory containing DICOM files.

Synopsis

gdcmscanner [options] directory

Description

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

Parameters

-d --dir       DICOM directory
-t --tag %d,%d DICOM tag(s) to look for

Options

-p --print      Print output.
-r --recursive  Recusively descend directory.

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

Simple Usage

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

Complex Usage

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.

See Also

gdcmdump(1), gdcmraw(1)

Author

Mathieu Malaterre

Main developer

Info

11/24/2016 GDCM VER_FULL DICOM Manipulation.