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
DCIODVFY(1) DICOM PS3 - Validate DICOM objects DCIODVFY(1) NAME
dciodvfy - ACR/NEMA DICOM PS3 ... DICOM PS3 - Validate DICOM objects SYNOPSIS
dciodvfy [ -profile profilename ] [ -describe ] [ -dump ] [ -v|verbose ] [ -filename ] DESCRIPTION
dciodvfy reads the named dicom file and describes the type of information object (SOP class instance) contained therein, validating it against the standard and checking for required modules and attributes, and appropriate representation and values of attributes. 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: -profile profilename Validate not against the standard but the IOD matching the named profile. -describe Describe the contents of the object without getting too verbose. -dump Dump the attribute list; differs from dcdump in that the list is decorated with whether or not the attribute is used in the IOD and what information entity the attribute belongs to based on the IOD. -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
% dciodvfy test.dc3 Warning - Value dubious for this VR - (0x0008,0x0090) ... Retired Person Name form MRImage Error - Missing attribute Type 1 Required ... Element=<FileMetaInformationVersion> Module=... % dciodvfy -describe test.dc3 Warning - Value dubious for this VR - (0x0008,0x0090) ... Retired Person Name form MRImage Error - Missing attribute Type 1 Required ... Element=<FileMetaInformationVersion> Module=... CompositeIOD <MRImage> Module <FileMetaInformation> ... (0x0002,0x0010) UI Transfer Syntax UID ... ... Module <Patient> (0x0010,0x0010) PN Patient's Name ... ... FILES
SEE ALSO
dcentvfy(1), dcdump(1), dcfile(1), dcintro(1) AUTHOR
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved. BUGS
DICOM PS3 28 September 2008 DCIODVFY(1)