NAME
dctable - ACR/NEMA DICOM PS3 ... DICOM PS3 - Make tables of attribute
values
SYNOPSIS
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
implicit|explicit ]
DESCRIPTION
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.
OPTIONS
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:
-describe
Add a first line of output that is a header describing the
attributes in each column.
-nofilename
Do not include the filename in the table.
-noembeddedquotes
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
hexadecimal.
-k|key elementname|(0xgggg,0xeeee)
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
fetched.
-r|recurse
If any attribute is not found in the top level dataset, recurse
through sequence attribute items until the first instance is
found.
-ignorereaderrors
Attempt to extract key values even if errors encountered whilst
parsing DICOM file.
ENVIRONMENT
EXAMPLES
% dctable -k Rows -k Columns
-describe test.dc3
"Filename" "Rows" "Columns"
"test.dc3" "0x0100" "0x0100"
FILES
SEE ALSO
dcintro(1),dckey(1)
AUTHOR
Copyright (C) 2010. David A. Clunie. All rights reserved.
BUGS
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
depended on.