dctopnm(1) [debian man page]
DCTOPNM(1) DICOM PS3 - DICOM image to PNM file DCTOPNM(1) NAME
dctopnm - ACR/NEMA DICOM PS3 ... DICOM PS3 - DICOM image to PNM file SYNOPSIS
dctopnm [ -v|verbose ] [ -quiet|silent ] DESCRIPTION
dctopnm reads the named dicom or acr-nema input file and copies the raw image pixel data to a PNM file after adding a PGM or PPM header. The input file must be unencapsulated, and in the case of > 8 bit data, in the same byte order as desired in the output, since the raw bytes are copied from input to output without any conversion. Use dccp(1) first to change the encoding if necessary. Only the necessary number of bytes to encode the pixel data will be written (based on rows, columns, number of frames, samples per pixel and bits allocated); this means that for an odd number of bytes the extra DICOM padding byte will not be copied to the raw output. This prevents netpbm utilities freaking out with an error "reading magic number" if the padding byte is present. If any of the necessary attributes to calculate the correct pixel data length are missing, all encoded bytes will be written. OPTIONS
The PNM 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. ENVIRONMENT
EXAMPLES
% dcfile big.dc3 Meta: UID 1.2.840.10008.1.2.1 Meta: Description "Explicit VR Little Endian" Meta: ByteOrder Little Meta: VR Explicit Meta: Encapsulated No Data: UID 1.2.840.10008.1.2.2 Data: Description "Explicit VR Big Endian" Data: ByteOrder Big Data: VR Explicit Data: Encapsulated No % dctopnm big.dc3 big.pgm -endian big Rows = 512 Columns = 512 NumberOfFrames = 0 PhotometricInterpretation = MONOCHROME2 SamplesPerPixel = 1 BitsAllocated = 16 BitsStored = 16 HighBit = 15 PixelRepresentation = 1 PlanarConfiguration = 0x0 Rows*Columns*SamplesPerPixel*BitsAllocated/8 = 0x80000 Writing ... FILES
SEE ALSO
dccp(1), pnmtodc(1), rawtodc(1), dctoraw(1), dctopgm8(1), dcintro(1) AUTHOR
Copyright (C) 1993-2012. David A. Clunie DBA PixelMed Publishing. All rights reserved. BUGS
DICOM PS3 13 April 2012 DCTOPNM(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)