dicominfo

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

구문

info = dicominfo(filename)

info = dicominfo(filename,"dictionary",D)

info = dicominfo(___,Name=Value)

설명

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 메시지에서 메타데이터 읽어 들이기

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

입력 인수

filename — DICOM 파일 이름

문자형 벡터 | string형 스칼라

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

데이터형: char | string

D — 데이터 사전 파일

'dicom-dict.mat' (디폴트 값) | 문자형 벡터 | 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 파일에서 메타데이터를 읽어 들입니다.

UseVRHeuristic — VR 모드를 잘못 전환하는 비규격 DICOM 파일 읽음 여부

true 또는 1 (디폴트 값) | false 또는 0

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

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

데이터형: logical

UseDictionaryVR — 데이터형과 데이터 사전의 일치 여부

false 또는 0 (디폴트 값) | true 또는 1

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

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

데이터형: logical

출력 인수

info — DICOM 메타데이터

구조체

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

확장 기능

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2024b: 스레드 기반 환경 지원

dicominfo 함수는 이제 스레드 기반 환경을 지원합니다.

참고 항목

dicomanon | dicomdict | dicomdisp | dicomwrite | dicomlookup | dicomread | dicomuid | dicomFile (Medical Imaging Toolbox) | getAttribute (Medical Imaging Toolbox) | findAttribute (Medical Imaging Toolbox)