'\" t
.\"     Title: gdcmgendir
.\"    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 "GDCMGENDIR" "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"
gdcmgendir \- Tool to generate a DICOMDIR file from a File\-Set\&.
.SH "SYNOPSIS"
.PP
.if n \{\
.RS 4
.\}
.nf
gdcmgendir [options] file\-in file\-out
.fi
.if n \{\
.RE
.\}
.SH "DESCRIPTION"
.SH "PARAMETERS"
.PP
.if n \{\
.RS 4
.\}
.nf
file\-in   DICOM input filename

file\-out  DICOM output filename
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.SS "Parameters"
.PP
.if n \{\
.RS 4
.\}
.nf
.fi
.if n \{\
.RE
.\}
.SS "specific options"
.PP
.if n \{\
.RS 4
.\}
.nf
  \-i \-\-input              DICOM filename or directory
  \-o \-\-output             DICOM filename or directory
  \-r \-\-recursive          recursive\&.
     \-\-descriptor         descriptor\&.
     \-\-root\-uid           Root UID\&.
.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
.\}
.SS "environment variable"
.PP
.if n \{\
.RS 4
.\}
.nf
  GDCM_ROOT_UID Root UID
.fi
.if n \{\
.RE
.\}
.SH "TYPICAL USAGE"
.SH "NOTE"
.PP
One may have to run some preliminary steps in order to get gdcmgendir to generate the DICOMDIR file\&. Namely two steps:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Batch renaming of the DICOM filename into something compatible with ISO 9660 filename convention
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Convert all DICOM file into the Explicit VR Little Endian Uncompressed (1\&.2\&.840\&.10008\&.1\&.2\&.1)
.RE
.sp
Step 1\&. can be solved in a numerous way\&. Eg\&. on UNIX environment this could either be solved using the mkisofs command line tool\&. Filenames should not contains any extension since the VR CS does not allow for the \*(Aq\&.\*(Aq character\&. Only upper case, digit 0\-9, the space \*(Aq \*(Aq and the underscore \*(Aq_\*(Aq character are valid in VR CS, with a maximum of 8 bytes\&. Another simple tool that can be handy is \*(Aqrename\*(Aq in conjunction with \*(Aqbasename\*(Aq\&.
.PP
Step 2\&. can simply be achieved using the gdcmconv command line tool:
.PP
.if n \{\
.RS 4
.\}
.nf
  $ for i in `ls IMG*`; do gdcmconv \-\-raw \-\-force $i /tmp/out/$i; done
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBgdcmconv\fR(1),
\fBgdcmanon\fR(1),
\fBrename\fR(1),
\fBmkisofs\fR(1)
.SH "AUTHOR"
.PP
\fBMathieu Malaterre\fR
.RS 4
Main developer
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2006, 2011 Mathieu Malaterre
.br