'\" t
.\"     Title: gdcmscanner
.\"    Author: Mathieu Malaterre
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 07/31/2021
.\"    Manual: DICOM Manipulation.
.\"    Source: GDCM 3.0.8
.\"  Language: English
.\"
.TH "GDCMSCANNER" "1" "07/31/2021" "GDCM 3\&.0\&.8" "DICOM Manipulation\&."
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gdcmscanner \- Scan a directory containing DICOM files\&.
.SH "SYNOPSIS"
.PP
.if n \{\
.RS 4
.\}
.nf
gdcmscanner [options] directory
.fi
.if n \{\
.RE
.\}
.SH "DESCRIPTION"
.PP
The
\fBgdcmscanner\fR
is a command line tool to quickly extract value from a set of DICOM attribute in a DICOM File\-Set\&.
.SS "PARAMETERS"
.PP
.if n \{\
.RS 4
.\}
.nf
  \-d \-\-dir       DICOM directory
  \-t \-\-tag %d,%d DICOM tag(s) to look for
.fi
.if n \{\
.RE
.\}
.SS "OPTIONS"
.PP
.if n \{\
.RS 4
.\}
.nf
  \-p \-\-print      Print output\&.
  \-r \-\-recursive  Recursively descend directory\&.
.fi
.if n \{\
.RE
.\}
.SS "general options"
.PP
.if n \{\
.RS 4
.\}
.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
.if n \{\
.RE
.\}
.SH "TYPICAL USAGE"
.SH "SIMPLE USAGE"
.PP
In order to display all the value for Patient Name (0010,0010) in the directory name
\fBgdcmData\fR, simply do:
.PP
.if n \{\
.RS 4
.\}
.nf
$ gdcmscanner \-t 10,10 \-d gdcmData \-p
.fi
.if n \{\
.RE
.\}
.SH "COMPLEX USAGE"
.PP
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:
.PP
.if n \{\
.RS 4
.\}
.nf
$ find gdcmData \-type d \-exec gdcmscanner \-t 10,10 \-d {} \-p \*(Aq;\*(Aq
.fi
.if n \{\
.RE
.\}
.PP
So all directory are locally traversed (no child directory are recursively traversed), which means results comes out much faster\&.
.SH "SEE ALSO"
.PP
\fBgdcmdump\fR(1),
\fBgdcmraw\fR(1)
.SH "AUTHOR"
.PP
\fBMathieu Malaterre\fR
.RS 4
Main developer
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2006, 2011 Mathieu Malaterre
.br