xenial (1) dcdirdmp.1.gz

Provided by: dicom3tools_1.00~20151213160232-2_amd64 bug

NAME

       dcdirdmp - ACR/NEMA DICOM PS3 ... DICOM PS3 - Describe DICOMDIR content

SYNOPSIS

       dcdirdmp [ -v|verbose|vv|veryverbose ] [ -showrecordinfo ] [ -description ] [ -p|paths ] [ -filename ]

DESCRIPTION

       dcdirdmp  reads  the  named  dicom  input file and interprets it as a DICOMDIR file, that is a DICOM file
       containing an instance of the Basic Directory IOD.

       If the file contains a valid instance of the directory, the hierarchical record  structure  is  traversed
       and  displayed  in  a  depth  first  manner.  The  default  output displays selected attribute values for
       recognized types of directory record, including the Referenced File ID. The verbose options increase  the
       amount of information dumped.

       Note  that  directory  record  offset  values  within  attributes are in bytes from the start of the file
       (including meta-information header and pre-amble) and these point to the beginning of the Item  delimiter
       that  introduces  each  item in the directory record sequence. The offset values displayed in the verbose
       output for the first attribute of each sequence item will therefore be  8  bytes  greater,  as  the  Item
       delimiter itself is not displayed.

OPTIONS

       The description and verbose output go to standard error.

       Binary attributes are written in hexadecimal with a preceding "0x". Numeric string attributes are written
       in decimal. Attribute values are displayed in hexadecimal or string format as  determined  by  the  value
       representation.

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

       -v|verbose
              Display all attributes in each directory record.

       -vv|veryverbose
              Display  byte  offset  from  file start and message start, in hexadecimal, and dump contents while
              reading and once read.

       -showrecordinfo
              Display byte offset with each directory record entry, in hexadecimal.

       -description
              Display the Study and Series Description attribute values.

       -p|paths
              Show Unix style path information for each referenced file only (suppresses normal output).   Used,
              for example, to feed paths as command line arguments to some other utility.

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

ENVIRONMENT

EXAMPLES

       % dcdirdmp DICOMDIR
       PATIENT SMITH^^^^ 1634-94
               STUDY 1  19960101 113013
                       VISIT
                       STUDY COMPONENT XA ?
                       SERIES 1 XA
                               IMAGE 2
                                -> XA000002

       % dcdirdmp -description DICOMDIR
       PATIENT Jones^Thomas 3648263
               STUDY 1  20110101 103425 CT Chest/Abdo/Pelvis
                       SERIES 1 CT Portal Venous Phase
                               IMAGE 1
                                -> DICOM\IM1

       % dcdirdmp -v DICOMDIR
       PATIENT SMITH^^^^ 1634-94
       (0x0004,0x1400) UL Next Directory Record Offset ...
        ...
       (0x0010,0x0010) PN Patient's Name VR=<PN> ...
        ...
       (0x0010,0x0020) LO Patient's ID ...
       (0x0010,0x0030) DA Patient's Birth Date ...
       (0x0010,0x0040) CS Patient's Sex  ...
               STUDY 1  19960101 113013
               (0x0004,0x1400) UL Next Directory Record Offset ...
        ...
               (0x0008,0x0050) SH Accession Number ...
       ...

       % dcdirdmp -vv dicomdir.
       ******** While reading ... ********
       @0x00000084,0x00000000 of 0xffffffff: (0x0002,0x0000) ...
        ...
       RootDirectoryFirstRecord = 0x190
       RootDirectoryLastRecord = 0x190
       Number of records = 7
       Offset = 0x190
               @0x00000198: (0x0004,0x1400) UL Next Dir Record ...
       ...
       Offset = 0x2a4
               @0x000002ac: (0x0004,0x1400) UL Next Dir Record ...
        ...
       PATIENT 1634-94-1 1634-94
       @0x00000198: (0x0004,0x1400) UL Next Dir Record Offset ...
        ...
       @0x00000268: (0x0010,0x0010) PN Patient's Name ...
        ...

FILES

SEE ALSO

       dcdump(1), dcintro(1)

AUTHOR

       Copyright (c) 1993-2015, David A. Clunie DBA PixelMed Publishing. All rights reserved.

BUGS

       MRDR not yet handled properly.