Documentation

dicominfo

Read metadata from DICOM message

Syntax

info = dicominfo(filename)
info = dicominfo(filename, 'dictionary', D)
info = dicominfo(___,'UseVRHeuristic', TF)
info = dicominfo(___, 'UseDictionaryVR', TF)

Description

info = dicominfo(filename) reads the metadata from the compliant Digital Imaging and Communications in Medicine (DICOM) file specified in the string filename.

info = dicominfo(filename, 'dictionary', D) uses the data dictionary file given in the string D to read the DICOM message. The file in D must be on the MATLAB® search path. The default file is dicom-dict.mat.

info = dicominfo(___,'UseVRHeuristic', TF) instructs the parser to use a heuristic to help read certain noncompliant files which switch value representation (VR) modes incorrectly. dicominfo displays a warning if the heuristic is used. When TF is true (the default), a small number of compliant files will not be read correctly. Set TF to false to read these compliant files.

info = dicominfo(___, 'UseDictionaryVR', TF) specifies whether the data types in INFO should conform to the data dictionary, regardless of what information is present in the file. The default value is false, which uses the file's VR codes even if they differ from the data dictionary. Most of the time it is unnecessary to set this field, since file contents and the data dictionary almost always agree. When TF is false (the default), dicominfo issues a warning when they do not agree. Set TF to true when the warning is issued and providing info to dicomwrite causes errors.

Examples

info = dicominfo('CT-MONO2-16-ankle.dcm')

info = 

                          Filename: [1x62 char]
                       FileModDate: '18-Dec-2000 11:06:43'
                          FileSize: 525436
                            Format: 'DICOM'
                     FormatVersion: 3
                             Width: 512
                            Height: 512
                          BitDepth: 16
                         ColorType: 'grayscale'
                    SelectedFrames: []
                        FileStruct: [1x1 struct]
                  StartOfPixelData: 1140
    FileMetaInformationGroupLength: 192
        FileMetaInformationVersion: [2x1 uint8]
           MediaStorageSOPClassUID: '1.2.840.10008.5.1.4.1.1.7'
                          .
                          .
                          .

Introduced before R2006a

Was this topic helpful?