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

NAME

6       gdcmscanner - Scan a directory containing DICOM files.
7

SYNOPSIS

9           gdcmscanner [options] directory
10

DESCRIPTION

12       The gdcmscanner is a command line tool to quickly extract value from a
13       set of DICOM attribute in a DICOM File-Set.
14
15   PARAMETERS
16             -d --dir       DICOM directory
17             -t --tag %d,%d DICOM tag(s) to look for
18             -k --keyword %s           DICOM keyword(s) to look for
19             -P --private-tag %d,%d,%s DICOM private tag(s) to look for
20
21   OPTIONS
22             -p --print      Print output.
23             -r --recursive  Recursively descend directory.
24                --strict     Use strict parser (faster but less tolerant with bogus DICOM files).
25                --table      Use Table output.
26
27   general options
28             -h   --help
29                    print this help text and exit
30
31             -v   --version
32                    print version information and exit
33
34             -V   --verbose
35                    verbose mode (warning+error).
36
37             -W   --warning
38                    warning mode, print warning information
39
40             -E   --error
41                    error mode, print error information
42
43             -D   --debug
44                    debug mode, print debug information
45

TYPICAL USAGE

SIMPLE USAGE

48       In order to display all the value for Patient Name (0010,0010) in the
49       directory name gdcmData, simply do:
50
51           $ gdcmscanner -t 10,10 -d gdcmData -p
52
53       For private tag simply do:
54
55           $ gdcmscanner -P "0029,60,SIEMENS MEDCOM HEADER2" -d gdcmData -p
56

TABLE USAGE

58       In order to display as CSV (see dicom3tools/dctable) all the values for
59       SOP Instance / Study Instance / Series Instance UID(s) in the directory
60       name gdcmData, simply do:
61
62           $ gdcmscanner -k SOPInstanceUID -k StudyInstanceUID -k SeriesInstanceUID -d gdcmData -p --table
63

COMPLEX USAGE

65       Because gdcmscanner does not support progress, you have to wait until
66       all files are traversed to see any results. This is quite cumbersome,
67       on UNIX this can be worked around with the following trick:
68
69           $ find gdcmData -type d -exec gdcmscanner -t 10,10 -d {} -p ';'
70
71       So all directory are locally traversed (no child directory are
72       recursively traversed), which means results comes out much faster.
73

SEE ALSO

75       dctable(1), gdcmdump(1), gdcmraw(1)
76

AUTHOR

78       Mathieu Malaterre
79           Main developer
80
82       Copyright © 2006, 2011 Mathieu Malaterre
83
84
85
86GDCM 3.0.21                       02/06/2023                    GDCMSCANNER(1)
Impressum