Scroll to navigation

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 ] [ -new|newformat ] [ -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:

Validate against the IOD matching the named profile. Currently supported profiles that specialize the DICOM standard IODs with additional requirements are
Describe the contents of the object without getting too verbose.
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.
Use new format for error messages that includes full path to offending attribute, and uses standardardized order of type of error or warning, path to attribute, message, value (if any) and additional information.
Display byte offset from file start and message start, in hexadecimal, and dump contents while reading and once read.
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 - (0x0010,0x0010) PN Patient's Name PN [0] = <SMITH> - Retired Person Name form
MRImage
Error - Missing attribute Type 1 Required ...
Element=<FileMetaInformationVersion> Module=...

% dciodvfy -new test.dc3
Warning - </PatientName(0010,0010)> - Value dubious for this VR [PN] - <SMITH> - Retired Person Name form
...

% 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-2022, David A. Clunie DBA PixelMed Publishing. All rights reserved.

BUGS

2 August 2021 DICOM PS3