Main Content

dicomread

DICOM 영상 읽어 들이기

페이지 내 모두 축소

구문

X = dicomread(filename)
X = dicomread(info)
X = dicomread(___,"frames",f)
X = dicomread(___,Name,Value)
[X,cmap] = dicomread(___)
[X,cmap,alpha] = dicomread(___)
[X,cmap,alpha,overlays] = dicomread(___)

설명

X = dicomread(filename)은 DICOM(Digital Imaging and Communications in Medicine: 의료용 디지털 영상 및 통신) 규격의 파일 filename에서 영상 데이터를 읽어 들입니다. 볼륨을 구성하는 시리즈 영상이 포함된 DICOM 파일 모음을 읽어 들이려면 dicomreadVolume을 사용하십시오.

예제

X = dicomread(info)는 DICOM 메타데이터 구조체 info에서 참조된 메시지에서 DICOM 영상 데이터를 읽어 들입니다.

X = dicomread(___,"frames",f)는 위에 열거된 구문의 입력 인수의 조합을 사용하여 영상에서 지정된 프레임 f만 읽어 들입니다.

X = dicomread(___,Name,Value)는 구문 분석기를 구성하는 이름-값 인수를 사용하여 DICOM 영상 데이터를 읽어 들입니다.

[X,cmap] = dicomread(___)는 컬러맵 cmap도 반환합니다.

[X,cmap,alpha] = dicomread(___)는 X에 대한 알파 채널 행렬인 alpha도 반환합니다.

[X,cmap,alpha,overlays] = dicomread(___)는 DICOM 파일에서 오버레이도 반환합니다.

예제

모두 축소

라이브 스크립트 열기

DICOM 파일에서 인덱스 영상을 읽어 들인 후 montage를 사용하여 이를 표시합니다.

[X,map] = dicomread("US-PAL-8-10x-echo.dcm");
montage(X,map,"Size",[2 5]);

Figure contains an axes object. The hidden axes object contains an object of type image.

또 다른 DICOM 파일에서 영상을 읽어 들인 후 imshow를 사용하여 이를 표시합니다. 

info = dicominfo("CT-MONO2-16-ankle.dcm");
Y = dicomread(info);
figure
imshow(Y,[]);

Figure contains an axes object. The hidden axes object contains an object of type image.

입력 인수

모두 축소

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

데이터형: char | string

DICOM 메타데이터로, 구조체로 지정됩니다. dicominfo 함수를 사용하여 info 구조체를 만들 수 있습니다.

읽어 들일 프레임으로, 양의 정수 스칼라, 양의 정수로 구성된 벡터 또는 "all"로 지정됩니다. f가 숫자형인 경우 dicomread는 지정된 개수의 프레임만 영상에서 읽어 들입니다. 기본적으로 dicomread는 DICOM 영상의 모든 프레임을 읽어 들입니다.

이름-값 인수

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

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

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

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

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

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

데이터형: logical

출력 인수

모두 축소

DICOM 영상으로, 다음 옵션 중 하나로 반환됩니다.

  • 단일 프레임 회색조 영상 또는 인덱스 영상을 나타내는 m×n 행렬.

  • 단일 프레임 트루컬러(RGB) 영상을 나타내는 m×n×3 배열.

  • 멀티프레임 영상을 나타내는 4차원 배열.

데이터형: int8 | int16 | uint8 | uint16

영상 X와 연결된 컬러맵으로, 다음 옵션 중 하나로 반환됩니다.

  • X가 인덱스 영상이면 cmap은 [0, 1] 범위의 값을 갖는 c×3 숫자형 행렬로 반환됩니다. 각 행은 컬러맵의 하나의 색에 대한 빨간색, 녹색, 파란색 성분을 지정하는, 요소를 3개 가진 RGB 3색입니다.

  • X가 회색조 영상이거나 트루컬러 영상인 경우 cmap은 비어 있습니다([]).

데이터형: double

영상 X에 대한 알파 채널 행렬로, 음이 아닌 정수로 구성된 m×n 행렬 또는 4차원 배열로 반환됩니다. 불투명 픽셀인 경우 alpha 값은 0입니다. 그렇지 않은 경우 cmap에 대한 행 인덱스 값이 됩니다. alpha를 사용하려면 cmap의 RGB 값에 X의 값을 대입해야 합니다. alpha 출력값은 X와 높이와 너비가 동일하고, 멀티프레임 영상인 경우 4차원입니다. alpha는 X와 데이터형이 동일합니다.

데이터형: int8 | int16 | uint8 | uint16

DICOM 파일의 오버레이로, 이진 값으로 구성된 m×n 행렬 또는 4차원 배열로 반환됩니다. 각 오버레이는 X와 높이와 너비가 같은 1비트 흑백 영상입니다. 파일에 여러 개의 오버레이가 있는 경우 overlays는 4차원 멀티프레임 영상입니다. 파일에 오버레이가 없는 경우 overlays는 비어 있습니다([]).

데이터형: logical

세부 정보

모두 축소

지원되는 전송 구문 UID

dicomread 함수는 다음 픽셀 형식과 전송 구문 UID로 파일을 읽어 들입니다.

픽셀 형식전송 구문 UID
Implicit VR Little Endian1.2.840.10008.1.2
Explicit VR Little Endian1.2.840.10008.1.2.1
Explicit VR Big Endian1.2.840.10008.1.2.2
JPEG Baseline (Process 1)1.2.840.10008.1.2.4.50

JPEG Extended (Process 2 & 4)

1.2.840.10008.1.2.4.51

JPEG Spectral Selection, Non-Hierarchical (Process 6 & 8)

1.2.840.10008.1.2.4.53

JPEG Full Progression, Non-Hierarchical (Process 10 & 12)

1.2.840.10008.1.2.4.55

JPEG Lossless, Non-Hierarchical (Process 14)

1.2.840.10008.1.2.4.57

JPEG Extended, Hierarchical (Process 16 & 18)

1.2.840.10008.1.2.4.59

JPEG Spectral Selection, Hierarchical (Process 20 & 22)

1.2.840.10008.1.2.4.61

JPEG Full Progression, Hierarchical (Process 24 & 26)

1.2.840.10008.1.2.4.63

JPEG Lossless, Hierarchical (Process 28)

1.2.840.10008.1.2.4.65

JPEG Lossless, Non-Hierarchical, First-Order Prediction (Process 14 [Selection Value 1])

1.2.840.10008.1.2.4.70

RLE Lossless

1.2.840.10008.1.2.5

GE Implicit VR Little Endian Except Big Endian Pixels

1.2.840.113619.5.2

MPEG2 Main Profile / Main Level

1.2.840.10008.1.2.4.100

MPEG2 Main Profile / High Level

1.2.840.10008.1.2.4.101

MPEG-4 AVC/H.264 High Profile / Level 4.1

1.2.840.10008.1.2.4.102

MPEG-4 AVC/H.264 BD-compatible High Profile / Level 4.1

1.2.840.10008.1.2.4.103

MPEG-4 AVC/H.264 High Profile / Level 4.2 For 2D Video

1.2.840.10008.1.2.4.104

MPEG-4 AVC/H.264 High Profile / Level 4.2 For 3D Video

1.2.840.10008.1.2.4.105

MPEG-4 AVC/H.264 Stereo High Profile / Level 4.2

1.2.840.10008.1.2.4.106

HEVC/H.265 Main Profile / Level 5.1

1.2.840.10008.1.2.4.107

HEVC/H.265 Main 10 Profile / Level 5.1

1.2.840.10008.1.2.4.108

확장 기능

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | | | | | | | (Medical Imaging Toolbox) | (Medical Imaging Toolbox)