dckey1

Usage

Overview

dckey reads the named dicom input file and displays the values of the selected attributes.

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.

Options

The attribute values, description and verbose output go to standard error.

The basic input switches are described in dcintro(1). Options specific to this program are:

-describe

Display the tag, name, value representation and value length of the attribute.

-brief

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.

-ignorereaderrors

Attempt to extract key values even if errors encountered whilst parsing DICOM file.

-noerror

Do not report an error if the requested attribute was not found, just an empty value or line. Implied by -brief.

-d|decimal

Display the first (or only) value of a numeric attribute as a decimal value.

-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.

-filename

Show the name of the file supplied in the arguments; a hyphen will be reported if no filename was supplied.

Environment

Examples

% dckey -key Rows -key Columns -key ImageLocation

-describe test.dc3

(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

1.2.840.10008.5.1.4.1.1.2

1996.04.17

19:38:00

45.000000\-120.000000\120.000000

0x0200

% dckey -d -k Rows test.dc3

512

% dckey -brief -k Rows -k Columns test.dc3

Rows=0x200

Columns=0x200

Files