vdcminfo − Report information about DICOM part 10 files (or VX_DICOM objects)

vdcminfo [-H] [if=<inputfile>] [of=<outputfile>] [-iw] [-sw] [-s] [-a] [-t] [f=] [-f] [-d] [-x] [t=<value>] [-l] [-m] [-in] [-i] [-q] [-v] [-w]

Vdcminfo

reports information about DICOM part 10 files (or VX_DICOM objects). The output is sent to either the screen or a text file. The -in flag is used for correct(Unicode) display of international or foreign characters. Information about a specific frame or image can be reported using f= option. A specific tag can be reported with t=. Note that a certain tag may be present more than once in a given file. The reporting of all known tag is performed by the -v flag, while the -t flag will report also unknown tags. The -x parameter will provide extra formatting to the output, such as indentations for sequences. The -i flag specifies inverse operation, where the output text from vdcminfo can be parsed back into a DICOM file.

The input may either be a DICOM part 10 file or a VisionX file with at least one VX_DICOM element in it. If the input is a file, vdcminfo will try both file formats. The default filetype is VisionX, so if the input comes from a pipe, the -d flag must be set to indicate it is DICOM. The output format is the same as the input format.
The t= option now outputs only the tag value (potential incompatibility). The t= option can be used for private tags too, but its behaviour for files with implicit transfer syntax is undefined and unsupported.
If the command used to create a VisionX DICOM file is not vdcmtovx (as reported by the File Command field), the file type is defined as "modified DICOM" and all of its DICOM header information is deemed as unreliable.

if=<input filename> specifies name of a DICOM Part 10 input file or

VisionX file with a VX_DICOM element.

of=<output file>

specifies the output filename. Default is stdout.

-iw

wish format output

-sw

scan information, wish format output

-s

scan information

-a

output information for each DICOM element in file instead of global summary

-t

print all tags in file (including unrecognized ones without their contents)

f=<value>

Display nth frame or image information.

-f

print file-type information, i.e. VX_DICOM, p10_DICOM, unknown

-d

specify filetype is DICOM, not VX_DICOM. (only required with pipes)

-x

apply extra formatting in output (dashes to indicate sequence depth and remove all \n in comment fields

t=<value>

only display tag (8-digit hex number)

-l

list all known tags

-m

print modality type only

-q

quiet operation. Suppresses warning messages.

-v

print all recognized tags in file

-in

Display correct(Unicode) international or foreign characters. (Not implemented yet!)

-i

inverse: create a DICOM file from the output of vdcminfo

-w

verbose operation (usually -v). Prints some runtime information.

-y

print all tags in file (including unrecognized ones) with their contents. Warning: this feature may render the command execution unpredictable as it tries to show contents from undocumented tags; so it is highly recommended not to use this option inside scripts.

The -x extra formatting flag must be used for the inverse function

to work properly with sequences

The inverse function is not able to recapture images

The inverse function can only write in implicit VR little endian syntax

with undefined sequence lengths

When used with pipes, the -d flag must be used with DICOM files

(otherwise VisX is tried and fails)

StudyUID

DICOM study UID

SeriesUID

DICOM series UID

ImageUID

DICOM image UID

modality

the image modality

SOPClassUID

DICOM storage class UID

FRefUID

DICOM frame of reference UID

so

scanner options

rcon

reconstruction (convolution) kernel

CTDIvol

dose

sss

series number

ssa

acquisition number

ssi

image number

dfn

some sort of identifier number (it is the last number in the ImageUID, but maybe truncated if the number requires more than 32 bits)

nim

number of images

ippx

image position patient X

ippy

image position patient Y

ippz

image position patient Z

ioprx

image orientation patient Row-X

iopry

image orientation patient Row-Y

ioprz

image orientation patient Row-Z

iopcx

image orientation patient Column-X

iopcy

image orientation patient Column-Y

iopcz

image orientation patient Column-Z

ist

slice thickness

iss

slice spacing

ip

image pitch

xs

image resolution in X

ys

image resolution in Y

zs

image resolution in Z

ri

rescale intercept

rs

rescale slope

olay

overlay

errflag

vdcminfo error flag

errmsg

vdcminfo error message

revt

revolution time

scwd

single collimation width

tcwd

total collimation width

tspd

table speed

tfpr

table feed per rotation

sppf

spiral pitch factor

fm

image format (s=short)

ch

number of channels

xres

image resolution X

yres

image resolution Y

zres

image resolution Z

xs

image size X

ys

image size Y

zs

image size Z

pname

patient name

hnum

medical record number

sdate

date of study

atime

time of image acquisition

snum

series number

anum

acquisition number

tsyn

DICOM transfer syntax

errflag

vdcminfo error flag

errmsg

vdcminfo error message

When the image is not a valid DICOM image or the -f flag is used in conjuction with -iw or -sw, the following variable is present in the output:

ftype

file type (VX_DICOM, p10_dicom, any of the VisionX data components or unknown) For processed VX_DICOM files (derived DICOMs) the type reported is the same resulting type when omitting the VX_DICOM data components.

vdcmtovx(1), vdcme(1), vdcmb(1), vdcmls(1)

A. Biancardi & W. J. Kostis & B.G. Stein & A.B. Chan