niftiread

读取 NIfTI 图像

全页折叠

语法

V = niftiread(filename)
V = niftiread(headerfile,imgfile)
V = niftiread(info)

说明

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

示例

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 文件的名称，指定为字符串标量或字符向量。文件可以采用 NIfTI1 或 NIfTI2 文件格式。

  • 如果您未指定文件扩展名，则 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 中推出

另请参阅

|