niftiinfo

从 NIfTI 文件读取元数据

全页折叠

语法

info = niftiinfo(filename)

说明

info = niftiinfo(filename) 从由 filename 指定的神经图像信息学技术倡议 (NIfTI) 文件返回元数据 info。niftiinfo 函数支持 NIfTI1 和 NIfTI2 文件格式。

示例

示例

全部折叠

打开实时脚本

从 NIfTI 文件 brain.nii 加载元数据。

info = niftiinfo('brain.nii');

显示文件的版本。

info.Version
ans = 
'NIfTI1'

显示文件的像素维度。

info.PixelDimensions
ans = 1×3

     1     1     1

显示原始头文件内容。

info.raw
ans = struct with fields:
        sizeof_hdr: 348
          dim_info: ' '
               dim: [3 256 256 21 1 1 1 1]
         intent_p1: 0
         intent_p2: 0
         intent_p3: 0
       intent_code: 0
          datatype: 2
            bitpix: 8
       slice_start: 0
            pixdim: [1 1 1 1 0 0 0 0]
        vox_offset: 352
         scl_slope: 0
         scl_inter: 0
         slice_end: 0
        slice_code: 0
        xyzt_units: 0
           cal_max: 0
           cal_min: 0
    slice_duration: 0
           toffset: 0
           descrip: ''
          aux_file: ''
        qform_code: 0
        sform_code: 0
         quatern_b: 0
         quatern_c: 0
         quatern_d: 0
         qoffset_x: 0
         qoffset_y: 0
         qoffset_z: 0
            srow_x: [0 0 0 0]
            srow_y: [0 0 0 0]
            srow_z: [0 0 0 0]
       intent_name: ''
             magic: 'n+1 '

显示原始结构中的意图代码。

info.raw.intent_code
ans = 
0

输入参数

全部折叠

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

  • 如果您未指定文件扩展名，则 niftiinfo 查找具有扩展名 .nii（对于压缩文件，则为 .nii.gz）的文件。

  • 如果 niftiinfo 无法找到扩展名为 .nii 或 .nii.gz 的文件，则它会查找扩展名为 .hdr（如果文件已压缩，则为 .hdr.gz）的文件。在双文件 NIfTI 格式中，.hdr 文件保存与三维体关联的元数据。

数据类型: char | string

输出参量

全部折叠

与 NIfTI 三维体关联的元数据，以结构体形式返回。

niftiinfo 以简化形式返回头文件中的元数据。该函数重命名、重新排序字段并将其打包为更易于读取的 MATLAB® 结构体。例如，niftiinfo 从文件元数据的 cal_max 和 cal_min 字段创建 DisplayIntensityRange 字段。要以元数据在文件中的显示形式查看元数据，请参阅返回的结构体的 raw 字段。

参考

[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 中推出

另请参阅

|