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:

       -profile profilename
              Validate  against  the IOD matching the named profile. Currently supported profiles
              that specialize the DICOM standard IODs with additional requirements are

              IHEREM (specializes XRayRadiationDoseSR),

              IHEMammo          (specializes          MammographyImageForProcessing           and
              MammographyImageForPresentation),

              IHEMammoProfileWithPartialViewOption (specializes MammographyImageForPresentation),

              IHEDBT (specializes BreastTomosynthesisImage),

              IHEXDSIManifest (specializes KeyObjectSelectionDocument),

              Dental   (specializes   IntraoralImageForPresentation,  DXImageForPresentation  and
              BasicDirectory)

       -describe
              Describe the contents of the object without getting too verbose.

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

       -new|newformat
              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.

       -verbose
              Display byte offset from file start and message start,  in  hexadecimal,  and  dump
              contents while reading and once read.

       -filename
              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