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)는 Name,Value 쌍을 사용하여 추가 옵션을 구문 분석기에 제공합니다. 여러 개의 이름-값 쌍을 지정할 수 있습니다.

예제

모두 축소

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

라이브 스크립트 열기

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

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

info = struct with fields:
                          Filename: '/mathworks/devel/bat/Bdoc21a/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.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: [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.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^® 검색 경로에 있어야 합니다. 디폴트 파일은 dicom-dict.mat입니다.

데이터형: char | string

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

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

`'UseVRHeuristic'` — VR 모드를 잘못 전환하는 비규격 DICOM 파일 읽음 여부
`true` (디폴트 값) | `false`

VR(Value Representation) 모드를 잘못 전환하는 비규격 DICOM 파일을 읽을지 여부로, 'UseVRHeuristic'과 함께 true 또는 false가 쉼표로 구분되어 지정됩니다.

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

데이터형: logical

`'UseDictionaryVR'` — 데이터형과 데이터 사전의 일치 여부
`false` (디폴트 값) | `true`

info의 데이터형이 데이터 사전과 일치하는지 여부로, 파일에 어떤 정보가 담겨 있는지와는 무관합니다. 디폴트 값은 false입니다. 이 경우 파일의 VR 코드가 데이터 사전과 다르더라도 해당 VR 코드를 사용합니다. 파일 내용과 데이터 사전이 거의 항상 일치하기 때문에, 대부분의 경우 이 필드를 설정할 필요가 없습니다. UseDictionaryVR이 false(디폴트 값)일 때 파일 내용과 데이터 사전이 일치하지 않으면 dicominfo는 경고를 발생시킵니다. 이 경고가 발생하고 info를 dicomwrite에 제공했을 때 오류가 발생하면 UseDictionaryVR을 true로 지정하십시오.

데이터형: logical

출력 인수

모두 축소

`info` — DICOM 메타데이터
구조체

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

참고 항목

R2006a 이전에 개발됨

dicominfo

구문

설명