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 파일 읽어 들이기

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

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

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

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

입력 인수

filename — DICOM 파일 이름

문자형 벡터 | string형 스칼라

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

데이터형: char | string

info — DICOM 메타데이터

구조체

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

f — 읽어 들일 프레임

"all" (디폴트 값) | 양의 정수 스칼라 | 양의 정수로 구성된 벡터

읽어 들일 프레임으로, 양의 정수 스칼라, 양의 정수로 구성된 벡터 또는 "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 파일에서 영상 데이터를 읽어 들입니다.

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

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

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

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

데이터형: logical

출력 인수

X — DICOM 영상

m×n 행렬 | m×n×3 배열 | 4차원 배열

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

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

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

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

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

cmap — 컬러맵

c×3 행렬 | []

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

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

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

데이터형: double

alpha — 알파 채널 행렬

음이 아닌 정수로 구성된 mxn 행렬 | 음이 아닌 정수로 구성된 4차원 배열

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

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

overlays — 오버레이

이진 m×n 행렬 | 이진 4차원 배열 | []

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

데이터형: logical

세부 정보

지원되는 전송 구문 UID

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

픽셀 형식	전송 구문 UID
Implicit VR Little Endian	1.2.840.10008.1.2
Explicit VR Little Endian	1.2.840.10008.1.2.1
Explicit VR Big Endian	1.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

확장 기능

스레드 기반 환경

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

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

버전 내역

R2006a 이전에 개발됨

R2024b: 스레드 기반 환경 지원

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

R2022b: 비디오 데이터 읽기 지원

이제 dicomread 함수는 MPEG-2, MPEG-4/H.264, HEVC/H.265 인코딩으로 비디오 데이터가 포함된 DICOM 파일 읽기를 지원합니다. MATLAB^®은 컴퓨터에 설치된 코덱을 사용하여 비디오 데이터를 디코딩하므로 일부 파일은 모든 플랫폼에서 읽어 들이지 못할 수 있습니다. 자세한 내용은 지원되는 비디오 및 오디오 파일 형식 항목을 참조하십시오.

참고 항목

dicomanon | dicomreadVolume | dicomdict | dicomdisp | dicominfo | dicomlookup | dicomwrite | dicomuid | dicomFile (Medical Imaging Toolbox) | getPixelData (Medical Imaging Toolbox)