dctable - ACR/NEMA DICOM PS3 ... DICOM PS3 - Make tables of attribute
dctable " inputfile1 [ inputfile2 ... ]" [ -ignorereaderrors ] [
-v|verbose ] [ -r|recurse ] [ -describe ] [ -nofilename ] [
-noembeddedquotes ] [ -key|k elementname|(0xgggg,0xeeee) ]
... [ -input-nometa ] [ -input-ts uid ] [ -input-default ]
[ -input-byteorder|-input-endian big|little ] [ -input-vr
dctable reads the named dicom input files and creates a tab delimited
table of the values of the selected attributes, with each value
enclosed in double quotes.
Binary attributes are written in hexadecimal with a preceding "0x".
Numeric string attributes are written in decimal.
The first column always contains the filenames.
A header is a added only if the -describe option is specified.
If a specified attribute is not present in a file, then it the
corresponding entry in the table will be empty (i.e. two consecutive
quotes" but this is not reported as an error.
The table of attribute values go to standard output, and the verbose
output and errors go to standard error.
The basic input switches are described in dcintro(1). Options specific
to this program are:
Add a first line of output that is a header describing the
attributes in each column.
Do not include the filename in the table.
Remove embedded quotes (") from within displayed values to allow
them to be parsed consistenty later; also has the side effect of
displaying numeric binary values as decimal rather than
Add a key to the list of attributes to be extracted. The
attribute may also be specified as a hexadecimal pair of the
form (0xgggg,0xeeee), which also allows private attributes to be
If any attribute is not found in the top level dataset, recurse
through sequence attribute items until the first instance is
Attempt to extract key values even if errors encountered whilst
parsing DICOM file.
% dctable -k Rows -k Columns
"Filename" "Rows" "Columns"
"test.dc3" "0x0100" "0x0100"
Copyright (C) 2010. David A. Clunie. All rights reserved.
Attempts to extract sequences or OB,OW attributes may fail nastily.
The order in which the attributes are extracted and written is not the
same order as they are specified on the command line, and should not be