让光声结果可以重做：校准、元数据和数据版本的最小流程

SECTION 01原始数据与展示结果分开保存

原始层保存尽可能接近采集输出的波形和设备元数据；处理层保存基线扣除、滤波、能量归一化与重建的明确配置；展示层保存色图、动态范围、裁剪与注释。原始层只读，重新处理生成新结果，而不是覆盖旧文件。这样发现错误时，能判断它来自采集、处理还是展示。

IPASC 共识数据格式以 HDF5 保存光声原始时间序列及配套元数据，并提供 PACFISH 转换工具。论文强调采样率、设备与几何等信息对交换和重建的作用。采用此格式有助于统一表达，但仍需填写准确数据，并记录格式与转换器版本。（来源 1）

SECTION 02实验开始前，校准检查要能留下记录

起始检查应覆盖采样时间轴、触发与零点、通道排序、探头位置、失效通道、脉冲能量监测和介质温度。校准结果不应只写在实验者记忆里，而应关联到具体设备编号、日期与数据批次。对无法校准的量，记录采用的假设和合理不确定范围，比填一个没有依据的精确小数更好。

一个教学排错例子：若 40 MHz 采样中，波形导出时丢失前四个采样点，却没有更新零点，则时间错位为 100 纳秒。在 1500 米每秒的均匀介质中对应 0.15 毫米的一程传播距离。脚本可以完全重复地生成错误图像，所以“重复运行相同”并不足以证明测量链正确。

SECTION 03每个处理结果关联一份不可含糊的配置

建议为每次运行记录数据文件校验值、代码提交或压缩包版本、依赖版本、配置文件、随机种子和输出目录。配置里同时保存数值与单位，例如采样率用 Hz、坐标用米；保存坐标轴方向与原点，不把“第一个维度”当作几何定义。带宽、正则参数、插值与终止条件都属于结果的一部分。

SIMPA 的原始研究以模块化的光学与声学模拟、处理流程连接不同环节，并支持向 IPASC 格式导出。对学习项目，它提示了一个有用原则：把光传播、声传播和重建的参数分开管理，才能在更换其中一个模块时追踪结果变化，而不是依赖一份不断手改的大脚本。（来源 2）

• raw：原始波形、设备信息、采集日志和校验值。
• config：本次处理的全部参数、单位和输入引用。
• derived：预处理、重建、统计结果与运行日志。
• figures：由确定结果生成的图，以及色图和裁剪设置。

SECTION 04模拟数据也要有来源和误差预算

模拟真值不是现实真值。需要记录目标生成方法、组织参数、边界条件、网格与时间步长，以及噪声是在哪一层加入的。训练、调参与评估数据的随机种子和结构来源应分开，防止同一对象的变形版本跨集合泄漏，造成对新对象性能的过高估计。

k-Wave 官方示例通过不同重建网格与加噪测量讨论避免逆犯罪。可以将这一思路扩展为预先列出的误差预算：声速偏差、坐标扰动、有限带宽与通道失效分别改变一次。每次只改变一个条件，保留基准，才能解释结果对哪类假设敏感。（来源 3）

SECTION 05发布前用一次独立重做检查链条是否闭合

把一小组允许共享的数据、配置、环境说明和执行入口交给未参与处理的人，在新目录中重做核心结果。核对数组尺寸、坐标方向、数值范围、评价表和最终图片，而不只检查脚本是否退出成功。若需要手动找文件或凭经验挑 ROI，就应把这些步骤写成可追踪配置。

这一检查不必要求不同硬件产生逐位相同的浮点输出，但需提前定义容许差异和比较对象。数据无法公开时，可发布去标识的可共享子集或结构相近的教学数据，同时清楚说明它不能复现实测结论。元数据格式、版本记录和诚实的共享边界，共同决定结果能否被理解与复核。