gdcmscanner(1) [debian man page]

gdcmscanner(1)							       GDCM							    gdcmscanner(1)

NAME

       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

Typical usage
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)

COPYRIGHT

       Copyright (c) 2006-2011 Mathieu Malaterre

Version 2.2.0							  Tue Feb 5 2013						    gdcmscanner(1)

gdcmgendir(1)							       GDCM							     gdcmgendir(1)

NAME

       gdcmgendir - Tool to generate a DICOMDIR file from a File-Set.

SYNOPSIS

       gdcmgendir [options] file-in file-out

DESCRIPTION

PARAMETERS

       file-in	 DICOM input filename

       file-out  DICOM output filename

options
   Parameters
   options
	 -i --input		 DICOM filename or directory
	 -o --output		 DICOM filename or directory
	 -r --recursive 	 recursive.
	    --descriptor	 descriptor.
	    --root-uid		 Root UID.

   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

   environment variable
	 GDCM_ROOT_UID Root UID

Typical usage
NOTE

       One may have to run some preliminary steps in order to get gdcmgendir to generate the DICOMDIR file. Namely two steps:

       o Batch renaming of the DICOM filename into something compatible with ISO 9660 filename convention
       o Convert all DICOM file into the Explicit VR Little Endian Uncompressed (1.2.840.10008.1.2.1)
       Step 1. can be solved in a numerous way. Eg. on UNIX environment this could either be solved using the mkisofs command line tool. filename
       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'.
       Step 2. can simply be achieved using the gdcmconv command line tool:
	 $ for i in `ls IMG*`; do gdcmconv --raw --force $i /tmp/out/$i; done
SEE ALSO

       gdcmconv(1), gdcmanon(1), rename(1)
COPYRIGHT

       Copyright (c) 2006-2011 Mathieu Malaterre

Version 2.2.0							  Tue Feb 5 2013						     gdcmgendir(1)