Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dctable(1) [debian man page]

DCTABLE(1)					    DICOM PS3 - Make tables of attribute values 					DCTABLE(1)

NAME

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

SYNOPSIS

       dctable	"  inputfile1  [  inputfile2  ... ]" [ -ignorereaderrors ] [ -v|verbose ] [ -r|recurse ] [ -describe ] [ -nofilename ] [ -noembed-
		 dedquotes ] [ -key|k  elementname|(0xgggg,0xeeee) ] ...  [ -input-nometa ] [ -input-ts  uid ] [ -input-default ]  [  -input-byte-
		 order|-input-endian  big|little ] [ -input-vr	implicit|explicit ]

DESCRIPTION

       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.

OPTIONS

       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:

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

       -nofilename
	      Do not include the filename in the table.

       -noembeddedquotes
	      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 hexadecimal.

       -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 fetched.

       -r|recurse
	      If  any attribute is not found in the top level dataset, recurse through sequence attribute items until the first instance is found.
	      This is a depth-first traversal, i.e., all children of the first item of a sequence are searched before the sibling items.

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

ENVIRONMENT


EXAMPLES


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

FILES


SEE ALSO

       dcintro(1),dckey(1)

AUTHOR

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

BUGS

       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.

DICOM PS3							   28 March 2012							DCTABLE(1)

Check Out this Related Man Page

DCFILE(1)					      DICOM PS3 - Describe DICOM file content						 DCFILE(1)

NAME

       dcfile - ACR/NEMA DICOM PS3 ... DICOM PS3 - Describe DICOM file content

SYNOPSIS

       dcfile [ -b|brief ] [ -filename ]

DESCRIPTION

       dcfile  reads the named dicom or acr-nema input file and describes the encoding method of the file, ie. what transfer syntax is in use, and
       whether or not a Part 10 style meta-information header is present.

OPTIONS

       The description goes to standard error.

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

       -b|brief
	      Display a single line brief summary.

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

ENVIRONMENT


EXAMPLES


       % dcfile dicomdir.
       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.1
       Data: Description       "Explicit VR Little Endian"
       Data: ByteOrder Little
       Data: VR 	       Explicit
       Data: Encapsulated      No

       % dcfile expmeta.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
       Data: Description       "Implicit VR Little Endian"
       Data: ByteOrder Little
       Data: VR 	       Implicit
       Data: Encapsulated      No

       % dcfile NM.1
       Data: UID	       1.2.840.10008.1.2
       Data: Description       "Implicit VR Little Endian"
       Data: ByteOrder Little
       Data: VR 	       Implicit
       Data: Encapsulated      No

       % dcfile test.spi
       Data: ByteOrder Big
       Data: VR 	       Implicit
       Data: Encapsulated      No

       % dcfile -b evrlewm.dcm
       DICOM file, with metaheader, Explicit VR Little Endian

       % dcfile -b evrlenom.dcm
       DICOM file, no metaheader, Explicit VR Little Endian

FILES


SEE ALSO

       file(1), dcdump(1), dcintro(1)

AUTHOR

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

BUGS

DICOM PS3							   6 March 2007 							 DCFILE(1)
Man Page