DCTABLE(1)

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.

DICOM PS3 23 March 2010 DCTABLE(1)