Main Content

dicominfo

DICOM 메시지에서 메타데이터 읽어 들이기

설명

예제

info = dicominfo(filename)은 DICOM(Digital Imaging and Communications in Medicine: 의료용 디지털 영상 및 통신) 규격의 파일 또는 DICOS(Digital Imaging and Communication in Security: 보안용 디지털 영상 및 통신) 규격의 파일 filename에서 메타데이터를 읽어 들입니다.

info = dicominfo(filename,"dictionary",D)는 데이터 사전 파일 D를 사용하여 DICOM 메시지를 읽어 들입니다.

info = dicominfo(___,Name,Value)는 위에 열거된 구문의 입력 인수의 조합 외에 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다.

예제

모두 축소

DICOM 메시지에서 메타데이터를 읽어 들입니다.

info = dicominfo("CT-MONO2-16-ankle.dcm")
info = struct with fields:
                          Filename: 'B:\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: [2×1 uint8]
           MediaStorageSOPClassUID: '1.2.840.10008.5.1.4.1.1.7'
        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.5.1.4.1.1.7'
                    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: [1×1 struct]
                       StationName: 'CT01OC0'
                  StudyDescription: 'RT ANKLE'
      NameOfPhysiciansReadingStudy: [1×1 struct]
                     OperatorsName: [1×1 struct]
             ManufacturerModelName: 'GENESIS_ZEUS'
                PatientGroupLength: 18
                       PatientName: [1×1 struct]
            AcquisitionGroupLength: 10
                  SoftwareVersions: '03'
           RelationshipGroupLength: 134
                  StudyInstanceUID: '1.2.840.113619.2.1.1.322987881.621.736170080.681'
                 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

입력 인수

모두 축소

DICOM 파일 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

데이터형: char | string

데이터 사전 파일로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. D에 있는 파일은 MATLAB® 검색 경로에 있어야 합니다.

데이터형: char | string

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: dicominfo("CT-MONO2-16-ankle.dcm",UseVRHeuristic=false)는 발견법을 사용하지 않고 DICOM 파일에서 메타데이터를 읽어 들입니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: dicominfo("CT-MONO2-16-ankle.dcm","UseVRHeuristic",false)는 발견법을 사용하지 않고 DICOM 파일에서 메타데이터를 읽어 들입니다.

VR(Value Representation) 모드를 잘못 전환하는 비규격 DICOM 파일을 읽을지 여부로, 논리형 1(true) 또는 0(false)으로 지정됩니다.

true로 설정되면, dicominfo는 VR 모드를 잘못 전환하는 특정 비규격 DICOM 파일을 발견법(Heuristic)을 사용하여 읽어 들입니다. dicominfo는 이 발견법을 사용하는 경우 경고를 표시합니다. 이 발견법이 활성화된 경우, 일부 적은 수의 규격 파일을 올바르게 읽어 들일 수 없습니다. 이러한 규격 파일을 읽어 들이려면 UseVRHeuristicfalse로 설정하십시오.

데이터형: logical

데이터형과 데이터 사전의 일치 여부로, 논리형 0(false) 또는 1(true)로 지정됩니다. 이 인수가 true로 지정된 경우 info 출력 구조체는 파일에 어떤 정보가 담겨 있는지와는 무관하게 데이터 사전의 데이터형을 사용합니다. false로 지정된 경우, 파일의 VR 코드가 데이터 사전과 다르더라도 info는 파일의 VR 코드를 사용합니다. 파일 내용과 데이터 사전이 거의 항상 일치하기 때문에, 대개는 이 인수를 true로 지정할 필요가 없습니다.

하지만 파일과 데이터 사전이 불일치하고 UseDictionaryVRfalse로 설정된 경우 dicominfo에서 경고가 발생하며, infodicomwrite 함수로 전달할 때 오류가 발생할 수 있습니다. 이러한 오류를 해결하려면 UseDictionaryVRtrue로 지정하여 데이터 사전의 VR 코드를 사용하십시오.

데이터형: logical

출력 인수

모두 축소

DICOM 메타데이터로, 구조체로 반환됩니다.

버전 내역

R2006a 이전에 개발됨