VisionX V4 | VDCMINFO | VisionX V4 |
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. |
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 |