Man Linux: Main Page and Category List

NAME

       dchist - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image statistics

SYNOPSIS

       dchist  [  -h|histogram  ]  [  -csv  ] [ -withhighbits|highbitsonly ] [
                 -v|verbose ] [ -filename ]

DESCRIPTION

       dchist reads the named dicom or acr-nema input file and  describes  the
       statistics  of the image pixel data. The primary intent is to determine
       the zero order entropy of the image.

       The description and verbose output go to standard error.

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

       -h|histogram
              Display   table   of   pixel   value,   frequency,  probability,
              contribution to zero order entropy, and  cumulative  zero  order
              entropy. May generate a LOT of output !

       -csv
              Display  only  a  comma  separated value pair of pixel value and
              frequency,  one  line  per  value,  e.g.,  for  import  into   a
              statistical program or spreadsheet

       -withhighbits
              Include as well the values that are above Bits Stored and within
              Bits Allocated, such as might be  overlay  bits  (regardless  of
              whether or not there are any 60xx group elements).

       -highbitsonly
              Use  instead  the  values  that are above Bits Stored and within
              Bits Allocated, such as might be overlay  bits,  and  treat  all
              valid   pixel   values  below  Bits  Stored  inclusive  as  zero
              (regardless  of  whether  or  not  there  are  any  60xx   group
              elements).

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

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

ENVIRONMENT

EXAMPLES

       % dchist expmeta.dc3
       9.02366 Zero order entropy (bits per pixel)
       0x0     Smallest symbol value
       0       Smallest symbol length (bits)
       0x6e9   Largest symbol value
       11      Largest symbol length (bits)

       % dchist -h expmeta.dc3
       [0x0]   392 p=0.00598145  e=0.0441747   cum=0.0441747
        ...
       [0x6e9] 1   p=1.52588e-05 e=0.000244141 cum=9.02366

       9.02366 Zero order entropy (bits per pixel)
       0x0     Smallest symbol value
       0       Smallest symbol length (bits)
       0x6e9   Largest symbol value
       11      Largest symbol length (bits)

FILES

SEE ALSO

       dcstats(1), dcintro(1)

AUTHOR

       Copyright  (C)  1993-2010. David A. Clunie DBA PixelMed Publishing. All
       rights reserved.

BUGS