DCSTATS(1) DICOM PS3 - DICOM image statistics DCSTATS(1)NAME
dcstats - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image statistics
SYNOPSIS
dcstats [ -v|verbose ] [ -filename ]
DESCRIPTION
dcstats reads the named dicom or acr-nema input file and describes the statistics of the image pixel data. The primary intent is to deter-
mine if the pixel representation is unsigned or signed (regardless of what other attributes may specify).
The description and verbose output go to standard error.
The basic input switches are described in dcintro(1). Options specific to this program are:
-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.
-filename
Show the name of the file supplied in the arguments; a hyphen will be reported if no filename was supplied.
ENVIRONMENT EXAMPLES
% dcstats expmeta.dc3
Signed minimum value = 0x0 (0 dec)
Signed maximum value = 0x6e9 (1769 dec)
Unsigned minimum value = 0x0 (0 dec)
Unsigned maximum value = 0x6e9 (1769 dec)
Signed range = 0x6e9 (1769 dec)
Unsigned range = 0x6e9 (1769 dec)
Signed mean = 0x158 (344 dec) (19.446%)
Unsigned mean = 0x158 (344 dec) (19.446%)
Bits Stored = 16
Significant unsigned bits = 11
% dcstats impnone.dc3
Signed minimum value = 0xfa24 (64036 dec)
Signed maximum value = 0x638 (1592 dec)
Unsigned minimum value = 0x0 (0 dec)
Unsigned maximum value = 0xffff (65535 dec)
Signed range = 0xc14 (3092 dec)
Unsigned range = 0xffff (65535 dec)
Signed mean = 0xfec2 (65218 dec) (38.2277%)
Unsigned mean = 0x1cdd (7389 dec) (11.2749%)
Bits Stored = 16
Significant positive bits = 11
Significant negative bits = 11
Offset to make unsigned in hex is = 0x5dc
Offset to make unsigned in dec is = 1500
FILES SEE ALSO dchist(1), dcintro(1)AUTHOR
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved.
BUGS DICOM PS3 6 March 2007 DCSTATS(1)
Check Out this Related Man Page
DCTOPGM8(1) DICOM PS3 - DICOM image to PNM file DCTOPGM8(1)NAME
dctopgm8 - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image to PNM file
SYNOPSIS
dctopgm8 [ -v|verbose ] [ -quiet|silent ] -windowwidth width ] -windowlevel|windowcenter center ] -ignorewindow ] -voilut numberfromzero ]
-ignorevoilut ] -invertedgray ] -signed|unsigned ]
DESCRIPTION
dctopgm8 reads the named dicom or acr-nema input file, converts it to an 8 bit grayscale image by windowing or application of a VOI LUT and
saves it as a PGM file.
In the absence of overriding command line options, the default behavior is to apply the first VOI LUT found, else if none, the first pair
of window values in the input file, else if none, the full range of the input pixel values.
The input file must be unencapsulated.
OPTIONS
The PGM output goes where it is specified or standard out. The verbose output goes to standard error.
The basic input switches are described in dcintro(1). Options specific to this program are:
-quiet|silent
Suppress the normal description of image parameters.
-verbose
Display byte offset from file start and message start, in hexadecimal, and dump contents while reading, once read, during replace-
ment, and before writing.
-windowwidth width
The window width to use (also supresses use of any VOI LUT).
-windowlevel|windowcenter center
The window center to use (also supresses use of any VOI LUT).
-ignorewindow
Ignore window center and width values in the input file, and use the full pixel value range instead (if no other command line
options).
-voilut numberfromzero
Use the selected VOI LUT from the input file (indexed from 0 not 1).
-ignorevoilut
Ignore any VOI LUTs in the input file, and use the window values or the full pixel value range instead (if no other command line
options).
-invertedgray
Invert the grayscale, overriding the PhotometricInterpretation in the input file.
-signed|unsigned
Override the sign specified in the PixelRepresentation in the input file.
ENVIRONMENT EXAMPLES
% dctopgm8 file.dcm file.pgm
Read ...
Rows = 2294
Columns = 1914
NumberOfFrames = 0
PhotometricInterpretation = MONOCHROME2
SamplesPerPixel = 1
BitsAllocated = 16
BitsStored = 12
HighBit = 11
PixelRepresentation = 0
PlanarConfiguration = 0
RescaleIntercept = 0
RescaleSlope = 1
WindowCenter = 2905
WindowWidth = 900
VOILUTs = 3
PixelData Value Length = 0x85fe78
Setting window values extracted from object because present not set on command line
Using ...
Rows = 2294
Columns = 1914
NumberOfFrames = 1
PhotometricInterpretation = MONOCHROME2
SamplesPerPixel = 1
BitsAllocated = 16
BitsStored = 12
HighBit = 11
PixelRepresentation = 0
PlanarConfiguration = 0
RescaleIntercept = 0
RescaleSlope = 1
WindowCenter =
WindowWidth =
VOILUTs = 0 of 3
Rows*Columns*SamplesPerPixel*BitsAllocated/8 = 0x85fe78
Writing ...
Applying VOILUT 0
FILES SEE ALSO dccp(1), pnmtodc(1), rawtodc(1), dctopnm(1), dctoraw(1), dcintro(1)AUTHOR
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved.
BUGS DICOM PS3 04 December 2010 DCTOPGM8(1)