.TH "gdcmgendir" 1 "Mon Sep 5 2016" "Version 2.4.4" "GDCM" \" -*- nroff -*-
.ad l
.nh
.SH NAME
gdcmgendir \- Tool to generate a DICOMDIR file from a File-Set\&. 

.SH "SYNOPSIS"
.PP
.PP
.nf
gdcmgendir [options] file-in file-out
.fi
.PP
.SH "DESCRIPTION"
.PP
.SH "PARAMETERS"
.PP
.PP
.nf
file-in   DICOM input filename

file-out  DICOM output filename
.fi
.PP
.SH "OPTIONS"
.PP
.SS "Parameters"
.PP
.nf
.fi
.PP
.SS "OPTIONS"
.PP
.nf
  -i --input              DICOM filename or directory
  -o --output             DICOM filename or directory
  -r --recursive          recursive.
     --descriptor         descriptor.
     --root-uid           Root UID.
.fi
.PP
.SS "general options"
.PP
.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
.PP
.SS "environment variable"
.PP
.nf
  GDCM_ROOT_UID Root UID
.fi
.PP
.SH "Typical usage"
.PP
.SH "NOTE"
.PP
One may have to run some preliminary steps in order to get gdcmgendir to generate the DICOMDIR file\&. Namely two steps: 
.PD 0

.IP "\(bu" 2
Batch renaming of the DICOM filename into something compatible with ISO 9660 filename convention 
.IP "\(bu" 2
Convert all DICOM file into the Explicit VR Little Endian Uncompressed (1\&.2\&.840\&.10008\&.1\&.2\&.1)
.PP
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 '\&.' character\&. Only upper case, digit 0-9, the space ' ' and the underscore '_' character are valid in VR CS, with a maximum of 8 bytes\&. Another simple tool that can be handy is 'rename' in conjunction with 'basename'\&.
.PP
Step 2\&. can simply be achieved using the gdcmconv command line tool:
.PP
.PP
.nf
  $ for i in `ls IMG*`; do gdcmconv --raw --force $i /tmp/out/$i; done
.fi
.PP
.SH "SEE ALSO"
.PP
\fBgdcmconv\fP(1), \fBgdcmanon\fP(1), \fBrename\fP(1), \fBmkisofs\fP(1)
.SH "COPYRIGHT"
.PP
Copyright (c) 2006-2011 Mathieu Malaterre