本文详解nrrd格式中多文件切片（multi-slice）体积数据加载失败的根本原因——data file:字段语法不合规，并提供符合nrrd 0.4规范的标准化修正方案，确保itk、simpleitk、pynrrd等主流库可正确解析9个独立raw切片文件。
本文详解nrrd格式中多文件切片（multi-slice）体积数据加载失败的根本原因——data file:字段语法不合规，并提供符合nrrd 0.4规范的标准化修正方案，确保itk、simpleitk、pynrrd等主流库可正确解析9个独立raw切片文件。
在NRRD格式中，当体积数据由多个独立的原始二进制文件（如每张DICOM切片导出为单独.M01, .M02等）组成时，必须严格遵循规范声明其组织方式。原始头文件中如下写法是非法且不可解析的：
data file: I0023679.M01 I0023679.M02 I0023679.M03 ...
问题核心在于：NRRD规范（v0.4 §3.3.5）明确要求——若使用多文件模式，data file:字段的值必须字面量（literally）为LIST，后续文件名需另起新行、紧随其后，且该字段必须是整个header的最后一项。
✅ 正确写法如下（注意空格、换行与顺序）：
NRRD0004 # Complete NRRD file format specification at: # http://teem.sourceforge.net/nrrd/format.html type: short dimension: 3 space: left-posterior-superior sizes: 272 272 9 space directions: (0.59, 0.0, 0.0) (0.0, 0.59, 0.0) (0.0, 0.0, 2.5) kinds: domain domain domain endian: little encoding: raw space origin: (0.0, 0.0, 0.0) byte skip: 1609 data file: LIST I0023679.M01 I0023679.M02 I0023679.M03 I0023679.M04 I0023679.M05 I0023679.M06 I0023679.M07 I0023679.M08 I0023679.M09
? 关键要点说明：
- data file: LIST 必须独占一行，冒号后仅允许一个空格，之后直接换行；
- 所有切片文件路径（支持相对路径）各占一行，不得缩进、不得加引号、不得以空格分隔；
- LIST 是保留关键字，不可替换为list、List或任何其他变体；
- 该字段必须位于header末尾——其后不能有任何其他字段或注释，否则解析器将报错或静默截断；
- 若某切片文件名恰好为LIST，应改用相对路径规避冲突，例如 data file: ./LIST（此时视为单文件模式）。
? 验证建议：
使用 pynrrd 进行快速校验：
import nrrd
# 应成功加载为 shape=(272, 272, 9) 的numpy数组
data, header = nrrd.read('volume.nrrd')
print(data.shape, header['sizes']) # 输出: (272, 272, 9) ['272', '272', '9']⚠️ 注意：部分旧版工具（如早期ITK 4.x）对LIST语法支持不完善，建议升级至ITK 5.3+ 或使用pynrrd>=0.4.3。若仍失败，请检查byte skip: 1609是否对所有切片统一适用（通常应为0，除非每个文件头部含固定长度元数据）。
遵循此规范后，多切片NRRD体积即可被各类医学图像处理框架稳定识别与重建，彻底解决“单切片可读、多切片报错”的典型兼容性问题。
