主要内容

niftiread

读取 NIfTI 图像

说明

V = niftiread(filename) 读取当前文件夹中或路径上由 filename 指定的 NIfTI 图像文件,并在 V 中返回三维体数据。niftiread 函数支持 NIfTI1NIfTI2 文件格式。

示例

V = niftiread(headerfile,imgfile) 读取 NIfTI 头文件 (.hdr) 和图像文件 (.img) 对。

V = niftiread(info) 读取由元数据结构体 info 描述的 NIfTI 文件。要创建一个 info 结构体,请使用 niftiinfo 函数。

示例

示例

全部折叠

从一个 NIfTI 文件加载三维体数据。该文件使用 NIfTI 组合格式 - 图像和元数据在同一文件中。此类型的 NIfTI 文件的文件扩展名为 .nii

V = niftiread('brain.nii');

查看工作区中的变量。

whos V
  Name        Size                  Bytes  Class    Attributes

  V         256x256x21            1376256  uint8              

从一个 NIfTI 文件读取元数据。

info = niftiinfo('brain.nii');

使用 niftiinfo 返回的元数据结构体读取三维体图像。

V = niftiread(info);

查看工作区中的变量。

whos V
  Name        Size                  Bytes  Class    Attributes

  V         256x256x21            1376256  uint8              

输入参数

全部折叠

NIfTI 文件的名称,指定为字符串标量或字符向量。文件可以采用 NIfTI1NIfTI2 文件格式。

  • 如果您未指定文件扩展名,则 niftiread 查找具有 .nii 扩展名的文件。

  • 如果 niftiread 无法找到具有 .nii 扩展名的文件,则它查找文件的 gzip 版本,扩展名为 .nii.gz

  • 如果 niftiread 无法找到具有 .nii.gz 扩展名的文件,则它查找具有 .hdr.hdr.gz.img.img.gz 文件扩展名的文件。

  • 如果 niftiread 无法找到匹配上述任一选项的文件,则返回错误。

数据类型: char | string

包含元数据的文件的名称,指定为字符串标量或字符向量。NIfTI 头文件 (.hdr) 保存与 NIfTI 三维体关联的元数据。如果您未指定对应的 imgfile,则 niftiread 在同一文件夹中查找具有相同名称且扩展名为 .img 的文件。

数据类型: char | string

包含三维体的文件的名称,指定为字符串标量或字符向量。NIfTI 图像文件 (.img) 存储三维体数据。如果您未指定对应的头文件,则 niftiread 在同一文件夹中查找具有相同名称且扩展名为 .hdr 的文件。

数据类型: char | string

NIfTI 文件元数据,指定为由 niftiinfo 返回的结构体。

数据类型: struct

输出参量

全部折叠

三维体数据,以数值数组形式返回。

详细信息

全部折叠

参考

[1] Cox, R. W., J. Ashburner, H. Breman, K. Fissell, C. Haselgrove, C. J. Holmes, J. L. Lancaster, D. E. Rex, S. M. Smith, J. B. Woodward, and S. C. Strother. "A (sort of) new image data format standard: NiFTI-1." 10th Annual Meeting of Organisation of Human Brain Mapping, Budapest, Hungary, June 2004.

版本历史记录

在 R2017b 中推出

另请参阅

|