Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

dicomread

读取 DICOM 图像

说明

示例

X = dicomread(filename) 从符合医学数字成像和通信 (DICOM) 标准的文件 filename 中读取图像数据。要读取包含一系列图像(这些图像构成一个图像体)的一组 DICOM 文件,请使用 dicomreadVolume

X = dicomread(info) 从 DICOM 元数据结构体 info 引用的消息中读取 DICOM 图像数据。

X = dicomread(___,'frames',f) 仅从图像中读取 f 指定的帧。

X = dicomread(___,Name,Value) 使用 Name,Value 对组读取 DICOM 图像数据来配置解析器。

[X,cmap] = dicomread(___) 还返回颜色图 cmap

[X,cmap,alpha] = dicomread(___) 还返回 alpha,即 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. The axes 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. The axes contains an object of type image.

输入参数

全部折叠

DICOM 文件的名称,指定为字符向量或字符串标量。

数据类型: char | string

DICOM 元数据,指定为一种结构体。info 结构体由 dicominfo 函数生成。

要读取的帧,指定为整数标量、整数向量或 'all'。当 f 为数值时,dicomread 仅读取图像中具有指定编号的帧。默认情况下,dicomread 读取 DICOM 图像的所有帧。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN

示例: dicomread('CT-MONO2-16-ankle.dcm','UseVRHeuristic',false)

读取那些值表示法 (VR) 模式切换不当的不符合 DICOM 标准的文件,指定为以逗号分隔的对组,由 'UseVRHeuristic'truefalse 组成。

当设置为 true(默认值)时,dicomread 使用启发式算法以便读取某些 VR 模式切换不当的不符合 DICOM 标准的文件。如果使用启发式算法,dicomread 会显示警告。少数符合标准的文件将无法正确读取。请将 UseVRHeuristic 设置为 false 以读取这些符合标准的文件。

数据类型: logical

输出参数

全部折叠

DICOM 图像,返回为下列项之一。

  • 表示单帧灰度图像或索引图像的 m×n 矩阵

  • 表示单帧真彩色 (RGB) 图像的 m×n×3 数组

  • 表示多帧图像的四维数组。

数据类型: int8 | int16 | uint8 | uint16

与图像 X 相关联的颜色图。

  • 如果 X 是索引图像,则 cmap 将以 c×3 矩阵形式返回。颜色图中有 c 种颜色,每种颜色都由红色、绿色和蓝色像素值表示。

  • 如果 X 是灰度或真彩色图像,则 cmap 为空 ([])。

数据类型: double

图像 X 的 alpha 通道矩阵,以非负整数数组形式返回。如果像素不透明,alpha 的值为 0;否则,其值是 cmap 的行索引。要使用 alpha,必须将 X 中的值替换为 cmap 中的 RGB 值。alpha 的高度和宽度与 X 相同,且对于多帧图像是四维的。alpha 的数据类型与 X 相同。

数据类型: int8 | int16 | uint8 | uint16

来自 DICOM 文件的重叠区域。每个重叠区域均为 1 位黑白图像,其高度和宽度与 X 相同。如果文件中存在多个重叠区域,则 overlays 是四维多帧图像。如果文件中没有重叠区域,则 overlays 为空 ([])。

数据类型: logical

提示

  • 此函数从具有以下像素格式之一的文件中读取图像:

    • little-endian,隐式 VR,未压缩

    • little-endian,显式 VR,未压缩

    • big-endian,显式 VR,未压缩

    • JPEG(有损或无损)

    • JPEG2000(有损或无损)

    • 行程长度编码 (RLE)

    • GE 隐式 VR,带未压缩 BE 像素的 LE (1.2.840.113619.5.2)

在 R2006a 之前推出