本文详解 nrrd 文件中多文件切片（multi-slice）体积加载失败的根本原因——data file: 字段语法不合规，并提供符合 nrrd v4 规范的标准化修复方法及实操示例。
本文详解 nrrd 文件中多文件切片（multi-slice）体积加载失败的根本原因——data file: 字段语法不合规，并提供符合 nrrd v4 规范的标准化修复方法及实操示例。
在医学影像或科学计算场景中，NRRD（Nearly Raw Raster Data）格式因其简洁性与元数据灵活性被广泛用于存储三维体数据。当数据以“单切片多文件”形式组织（即每张二维切片保存为独立二进制文件，如 I0023679.M01, I0023679.M02…），NRRD 头部必须严格遵循规范声明其为多文件列表模式。常见错误是直接在 data file: 后换行罗列文件名，而未显式标注关键词 LIST——这会导致绝大多数标准解析器（如 ITK、pynrrd、3D Slicer）拒绝识别为合法多切片体积，仅能成功加载单个文件，却无法构建完整三维数组。
根据 NRRD v4 官方规范 第 3 条明确定义：
data file: LIST [<subdim>]
其中 LIST 是字面量关键字（literal string），不可省略；后续每行一个文件路径，且该字段必须为头部最后一项。
原文件中：
data file: I0023679.M01 I0023679.M02 ...
虽语义可读，但语法非法：data file: 后缺少 LIST，且缩进/空格不符合规范要求（规范要求 LIST 后紧跟换行，文件名独占一行，无前置空格或冒号后空格）。
✅ 正确写法如下（注意格式细节）：
data file: LIST I0023679.M01 I0023679.M02 I0023679.M03 I0023679.M04 I0023679.M05 I0023679.M06 I0023679.M07 I0023679.M08 I0023679.M09
关键规范要点总结：
- LIST 必须作为字面量紧接在 data file: 冒号后，后跟换行符（不可在同一行追加空格或文件名）；
- 所有切片文件路径独占一行，无缩进、无前导空格、无额外分隔符；
- data file: LIST 块必须位于 NRRD 头部末尾，其后不得再有任何其他字段（如空行也不推荐）；
- 若某切片文件名恰好为 LIST，需通过相对路径规避歧义，例如 data file: ./LIST（此时视为单文件模式）。
验证建议：使用命令行工具 unu head -i your_file.nrrd（来自 Teem 工具集）或 Python 库 pynrrd 加载测试：
import nrrd
data, header = nrrd.read('fixed_volume.nrrd') # 应返回 shape == (272, 272, 9)
print(data.shape) # 输出: (272, 272, 9)⚠️ 注意事项：
- byte skip: 1609 表明每个切片文件头部存在 1609 字节跳过区，需确保所有 .Mxx 文件结构一致，否则跨切片读取将错位；
- space directions 中第三轴 (0.0, 0.0, 2.5) 对应层厚 2.5mm，与 sizes: 272 272 9 共同定义物理空间，修改文件列表后务必保持该一致性；
- 编辑 NRRD 头部时推荐使用纯文本编辑器（禁用自动换行/UTF-8 BOM），避免不可见字符破坏解析。
遵循此规范后，NRRD 解析器即可正确识别多文件切片序列，按顺序读取、拼接并生成完整的三维 NumPy 数组或 ITK Image 对象，彻底解决“单切片正常、多切片失败”的典型问题。
