Man Linux: Main Page and Category List


       dctable  -  ACR/NEMA DICOM PS3 ... DICOM PS3 - Make tables of attribute


       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 ]


       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.


       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:

              Add a first line of output  that  is  a  header  describing  the
              attributes in each column.

              Do not include the filename in the table.

              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

       -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

              If  any attribute is not found in the top level dataset, recurse
              through sequence attribute items until  the  first  instance  is

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



       % dctable -k Rows -k Columns
               -describe test.dc3
       "Filename"     "Rows"    "Columns"
       "test.dc3"     "0x0100"  "0x0100"





       Copyright (C) 2010. David A. Clunie. All rights reserved.


       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.