Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dcsort(1) [debian man page]

DCSORT(1)					      DICOM PS3 - Make sorted list of images						 DCSORT(1)

NAME
dcsort - ACR/NEMA DICOM PS3 ... DICOM PS3 - Make sorted list of images SYNOPSIS
dcsort " inputfile1 [ inputfile2 ... ]" [ -v|verbose ] [ -vv|veryverbose ] [ -vvv|veryveryverbose ] [ -index ] [ -show ] [ -interval ] [ -tolerance mm ] [ -check ] [ -checkFoR ] [ -descending ] [ -sortby|k attributename ] DESCRIPTION
dcsort reads the named dicom input files and sorts them by the specified sort key. The sort key should be a single valued numeric attribute, with the exception of ImageOrientationPatient and ImagePositionPatient which are handled as special cases. There is no output by default unless the index or verbose options are specified. OPTIONS
The output and errors go to standard error. The basic input switches are described in dcintro(1). Options specific to this program are: -index Creates a first column of output that is the index in the sort order, starting from 0, and a second column that is the filename. -show Show the value of the sort key after the file name with the -index option -interval Show the interval between values of the sort key, or an error if not equal -tolerance mm The tolerance value in mm to use when comparing intervals between slices; defaults to +/- 0.01 mm if unspecified -check Check that all the images are from the same series. -checkFoR Check that all the images have the same Frame of Reference (UID). -descending Sort in descending, rather than the default ascending, order. -sortby|k attributename Specify attributename as the sort key. ENVIRONMENT
EXAMPLES
% dcsort -index -sortby SliceLocation ./1/[0-9]* 0 ./1/1 1 ./1/2 FILES
SEE ALSO
dcintro(1) AUTHOR
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. All rights reserved. BUGS
DICOM PS3 22 December 2006 DCSORT(1)

Check Out this Related Man Page

DCKEY(1)					       DICOM PS3 - Extract attribute values						  DCKEY(1)

NAME
dckey - ACR/NEMA DICOM PS3 ... Extract attribute values SYNOPSIS
dckey [ -ignorereaderrors ] [ -v|verbose ] [ -filename ] [ -describe ] [ -brief ] [ -d|decimal ] [ -key|k elementname|(0xgggg,0xeeee) ] ... DESCRIPTION
dckey reads the named dicom input file and displays the values of the selected attributes. Binary attributes are written in hexadecimal with a preceding "0x" and numeric string attributes are written in decimal as they are encoded, unless the -decimal option is specified. OPTIONS
The attribute values, description and verbose output go to standard error. The basic input switches are described in dcintro(1). Options specific to this program are: -describe Display the tag, name, value representation and value length of the attribute. -brief Display the keyword of the attribute, and equals sign, and then the value, for use in scripts that automatically extract multiple values in the same dckey invocation. Implies -noerror. -ignorereaderrors Attempt to extract key values even if errors encountered whilst parsing DICOM file. -noerror Do not report an error if the requested attribute was not found, just an empty value or line. Implied by -brief. -d|decimal Display the first (or only) value of a numeric attribute as a decimal value. -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. -filename Show the name of the file supplied in the arguments; a hyphen will be reported if no filename was supplied. ENVIRONMENT
EXAMPLES
% dckey -key Rows -key Columns -key ImageLocation -describe test.dc3 (0x0028,0x0010) US Rows VR=<US> VL=<0x0002> [0x0100] (0x0028,0x0011) US Columns VR=<US> VL=<0x0002> [0x0100] Error - Not found - (0x0028,0x0200) US Image Location % dckey -k Rows -k ImagePositionPatient -k StudyDate -k StudyTime -k SOPClassUID test.dc3 1.2.840.10008.5.1.4.1.1.2 1996.04.17 19:38:00 45.000000-120.000000120.000000 0x0200 % dckey -d -k Rows test.dc3 512 % dckey -brief -k Rows -k Columns test.dc3 Rows=0x200 Columns=0x200 FILES
SEE ALSO
dcintro(1),dctable(1) AUTHOR
Copyright (C) 1993-2010. David A. Clunie DBA PixelMed Publishing. 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. The -describe and other options cannot be used at the same time. The -decimal option uses a double conversion before displaying the value and there may be sign extension and precision issues with some values. The reading of the attributes from the DICOM file will not proceed past the top level Pixel Data attribute, in order to accelerate the speed of reading. DICOM PS3 19 November 2008 DCKEY(1)
Man Page

Featured Tech Videos