dckey - ACR/NEMA DICOM PS3 ... Extract attribute values
dckey [ -ignorereaderrors ] [ -v|verbose ] [ -filename ] [ -describe ]
[ -brief ] [ -d|decimal ] [ -key|k
elementname|(0xgggg,0xeeee) ] ...
dckey reads the named dicom input file and displays the values of the
Binary attributes are written in hexadecimal with a preceding "0x" and
numeric string attributes are written in decimal as they are encoded,
unless the -decimal option is specified.
The attribute values, description and verbose output go to standard
The basic input switches are described in dcintro(1). Options specific
to this program are:
Display the tag, name, value representation and value length of
Display the keyword of the attribute, and equals sign, and then
the value, for use in scripts that automatically extract
multiple values in the same dckey invocation. Implies -noerror.
Attempt to extract key values even if errors encountered whilst
parsing DICOM file.
Do not report an error if the requested attribute was not found,
just an empty value or line. Implied by -brief.
Display the first (or only) value of a numeric attribute as a
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
Show the name of the file supplied in the arguments; a hyphen
will be reported if no filename was supplied.
% dckey -key Rows -key Columns -key ImageLocation
(0x0028,0x0010) US Rows VR=<US> VL=<0x0002> [0x0100]
(0x0028,0x0011) US Columns VR=<US> VL=<0x0002> [0x0100]
Error - Not found - (0x0028,0x0200) US Image Location
% dckey -k Rows -k ImagePositionPatient
-k StudyDate -k StudyTime
-k SOPClassUID test.dc3
% dckey -d -k Rows test.dc3
% dckey -brief -k Rows -k Columns test.dc3
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All
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
The -describe and other options cannot be used at the same time.
The -decimal option uses a double conversion before displaying the
value and there may be sign extension and precision issues with some
The reading of the attributes from the DICOM file will not proceed past
the top level Pixel Data attribute, in order to accelerate the speed of