This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materials including this page, select Japan from the country navigator on the bottom of this page.


Read metadata from DICOM message


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


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

info = dicominfo(filename, 'dictionary',D) uses the data dictionary file given in the string or character vector 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.


collapse all

Read metadata from DICOM message.

info = dicominfo('CT-MONO2-16-ankle.dcm')
info = struct with fields:
                          Filename: '/mathworks/devel/bat/Bdoc17b/build/matlab/toolbox/images/imdata/CT-MONO2-16-ankle.dcm'
                       FileModDate: '18-Dec-2000 12:06:42'
                          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'
             PhysicianReadingStudy: [1x1 struct]
                      OperatorName: [1x1 struct]
             ManufacturerModelName: 'GENESIS_ZEUS'
                PatientGroupLength: 18
                       PatientName: [1x1 struct]
            AcquisitionGroupLength: 10
                   SoftwareVersion: '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

Introduced before R2006a

Was this topic helpful?