Main Content


Read metadata from DICOM message



info = dicominfo(filename) reads the metadata from the compliant Digital Imaging and Communications in Medicine (DICOM) file or Digital Imaging and Communication in Security (DICOS) file, filename.

info = dicominfo(filename,'dictionary',D) reads the DICOM message by using the data dictionary file, D.

info = dicominfo(___,Name,Value) provides additional options to the parser using Name,Value pairs. You can specify multiple name-value pairs.


collapse all

Read metadata from a DICOM message.

info = dicominfo('CT-MONO2-16-ankle.dcm')
info = struct with fields:
                          Filename: '/mathworks/devel/bat/Bdoc21b/build/matlab/toolbox/images/imdata/CT-MONO2-16-ankle.dcm'
                       FileModDate: '18-Dec-2000 12:06:43'
                          FileSize: 525436
                            Format: 'DICOM'
                     FormatVersion: 3
                             Width: 512
                            Height: 512
                          BitDepth: 16
                         ColorType: 'grayscale'
    FileMetaInformationGroupLength: 192
        FileMetaInformationVersion: [2x1 uint8]
           MediaStorageSOPClassUID: '1.2.840.10008.'
        MediaStorageSOPInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.1.736169244'
                 TransferSyntaxUID: '1.2.840.10008.1.2'
            ImplementationClassUID: '1.2.840.113619.6.5'
         ImplementationVersionName: '1_2_5'
      SourceApplicationEntityTitle: 'CTN_STORAGE'
            IdentifyingGroupLength: 414
                         ImageType: 'DERIVED\SECONDARY\3D'
                       SOPClassUID: '1.2.840.10008.'
                    SOPInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.1.736169244'
                         StudyDate: '1993.04.30'
                        SeriesDate: '1993.04.30'
                       ContentDate: '1993.04.30'
                         StudyTime: '11:27:24'
                        SeriesTime: '11:27:24'
                       ContentTime: '11:27:24'
                          Modality: 'CT'
                    ConversionType: 'WSD'
                      Manufacturer: 'GE MEDICAL SYSTEMS'
                   InstitutionName: 'JFK IMAGING CENTER'
            ReferringPhysicianName: [1x1 struct]
                       StationName: 'CT01OC0'
                  StudyDescription: 'RT ANKLE'
      NameOfPhysiciansReadingStudy: [1x1 struct]
                     OperatorsName: [1x1 struct]
             ManufacturerModelName: 'GENESIS_ZEUS'
                PatientGroupLength: 18
                       PatientName: [1x1 struct]
            AcquisitionGroupLength: 10
                  SoftwareVersions: '03'
           RelationshipGroupLength: 134
                  StudyInstanceUID: '1.2.840.113619.'
                 SeriesInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.736169244'
                      SeriesNumber: 365
                    InstanceNumber: 1
      ImagePresentationGroupLength: 168
                   SamplesPerPixel: 1
         PhotometricInterpretation: 'MONOCHROME2'
                              Rows: 512
                           Columns: 512
                     BitsAllocated: 16
                        BitsStored: 16
                           HighBit: 15
               PixelRepresentation: 1
           SmallestImagePixelValue: 0
                 PixelPaddingValue: 0
                      WindowCenter: 1024
                       WindowWidth: 4095
                  RescaleIntercept: -1024
                      RescaleSlope: 1
                       RescaleType: 'US'
              PixelDataGroupLength: 524296

Input Arguments

collapse all

Name of DICOM file, specified as a character vector or string scalar.

Data Types: char | string

Data dictionary file, specified as a character vector or string scalar. The file in D must be on the MATLAB® search path. The default file is dicom-dict.mat.

Data Types: char | string

Name-Value Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: dicominfo('CT-MONO2-16-ankle.dcm','UseVRHeuristic',false)

Read noncompliant DICOM files that switch value representation (VR) modes incorrectly, specified as the comma-separated pair consisting of 'UseVRHeuristic' and true or false.

When set to true (the default), dicomread uses a heuristic to help read certain noncompliant DICOM files that switch VR modes incorrectly. dicomread displays a warning if the heuristic is used. A small number of compliant files will not be read correctly. Set UseVRHeuristic to false to read these compliant files.

Data Types: logical

Conform data types in info 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.

If the file and the data dictionary disagree and UseDictionaryVR is set to false (the default), dicominfo issues a warning and you can experience errors passing info to dicomwrite. To resolve these errors, specify UseDictionaryVR as true to use the VR codes from the data dictionary.

Data Types: logical

Output Arguments

collapse all

DICOM metadata, returned as a struct.

Introduced before R2006a