研究问题
本页先区分量程、饱和、数据丢失与规则弃判。量程描述仪器在指定条件下可有效读出的输入区间；饱和是输入或处理链越界后的表现；失联意味着某些采样值根本不存在；弃判是软件对当前证据不足作出的输出选择。它们并不是同一个错误代码。
一条完整的事件卡必须让读者知道损失发生在哪一层。传感器前端截顶属于物理信息损失，通信缺值属于传输或数据完整性问题，时间偏移则影响事件对应关系。后端无法凭插值或重新画线补回原本没有被可靠测得的事实。
基础原理
零场型 OPM 在近零工作点附近通常有较窄的有效线性响应区间，外场偏置或瞬态可能把响应推出可解释范围。应区分仪器可容忍的环境背景、补偿可调整的范围与消零后读出动态范围；这些指标往往来自不同条件与不同测试方法。
厂商 QZFM Gen-3 列出的约 50 nT 背景条件和 ±5 nT 动态范围仅对该型号及其条件成立。GR-OPM 目前没有同类实测规格，因此不得以其数值定义本系统的告警阈值；V3 合成数据的截顶值也使用 a.u. 而非 nT。
系统结构图与数据边界
截顶示意必须区分观察到的饱和读数与假设的未截顶峰形，不用平滑重建曲线混淆二者。软件质量状态机先读取每个样本的有效性，再决定计算与可视化方式。
实际 CSV 中每个观察轴都有对应质量字段，包含 bx_status、by_status、bz_status、reference_status。LOST 数值为空，JS 解释为 null 并设置 plot_break=true；SATURATED 可保留裁切后的数值作显示，但不能把它当成完整真实峰幅参加有效特征判断。
变量与假设
制定数据质量门限前要知道通道是否有原始质量标记、状态标签在哪个环节产生、采样中断是否连续、最大缺口长度、饱和时是否同时存在补偿动作、时基是否稳定。这些条件决定统计上的有效覆盖率，也决定窗口是否具备讨论事件的资格。
错误的处理包括 Number(value || 0) 把空值悄悄变为零，或者删除失联点后直接连接相邻有效样本。这些写法会创造不存在的平滑段或突变，使基线、斜率、峰值与参考相似性产生系统性偏差，尤其容易在短事件窗口里误导。
设计取舍对照表
三种常见呈现策略是只隐藏异常样本、保留异常并明确标记、在报告层对异常窗口主动弃判。直接隐藏虽然简洁，却切断了复核链；明确标识保留数据事实，主动弃判则阻止坏数据继续进入场源归因。本页同时展示标记与弃判两层处理，而不以平滑曲线代替数据质量决定。
SIM-09 在 Bx 与 Bz 的合成读数上出现截顶，预设为 SENSOR_SATURATED 后弃判；SIM-12 的参考通道在 0.30–1.60 秒缺失，预设为 REFERENCE_LOST 后弃判。两种情形的可见曲线和原因字段都不同，不能统一改写成“噪声偏大”。
| 状态 | 数据表现 | 绘图与事件原则 |
|---|---|---|
| VALID | 存在有效数值 | 可以在合适窗口参与特征计算 |
| SATURATED | 保留截顶显示值 | 标出裁切，不当作真实峰幅 |
| LOST | 空值/null | 必须断线，不补零和不跨线 |
| OFFSET_UNCERTAIN | 时间归属不可靠 | 即使数值存在也需评估弃判 |
| ABSTAIN | 规则层输出 | 保留已知波形并说明无法归因 |
表中方法为研究设计或合成数据约束；未提供的硬件参数不构成设备规格。
适用条件和失效模式
当饱和从数据采集开始已经发生，后续滤波不会恢复超出量程的真实幅值；当缺失连续覆盖候选峰，统计模型也不应从左右端点推算事件真实形状。即使局部有效样本还可以绘图，也必须标出其不能代表完整窗口的原因。
此外，timebase_status=OFFSET_UNCERTAIN 使时间归属不可靠，即使四个通道数值都是 VALID，也可能无法将候选峰对应到闸机。软件质量决策应覆盖值域、连续性和时间解释三种不同维度。
真实外部来源
QuSpin QZFM 官方页面提供特定零场设备对强背景与瞬态的限制，并描述其规格测试条件。磁屏蔽室补偿论文展示残余场可能引发读出饱和以及控制环境的重要性。它们支持物理边界，但不提供 GR 项目饱和率、维修判别率或实际车库结果。
V3 的品质状态可由V3数据目录文件和分析模块直接复核，属于实际软件与 generated_data；源头“传感器发生某种物理故障”的叙述则不在这些合成事实能够确认的范围内。分清两个来源是阅读报告的必要条件。
相关阅读
接着阅读残余场与补偿线圈，可理解强背景怎样让测量链越界；阅读参考通道页，可看见 LOST 如何破坏差分；阅读信号管线，可理解质量状态为什么要先于峰值、事件卡和下载。
建议直接对照 SIM-09、SIM-12 的 SVG 与 JSON 报告：一份表现数据截顶，一份表现真实空值与断线。只看图片容易忽略细节，因此应同时查数据的四个状态列以及 decision.reasons[]。
问题定义
核心判断并非“是否出现一个大峰”，而是“该峰是否在允许的物理与数据条件下被完整记录”。量程、通道完整性、时钟和参考有效性都需要各自的证据；在任何关键条件不足时，弃判是一种明确的合格输出，而不是程序失败。
本页技术结论的边界是：我们已核验 V3 合成质量状态和规则处理路径，未证明真实 GR 探头、真实车库或起动机测量能力。后续应把硬件标定范围、原始饱和标志与软件状态生成机制逐项连接后再发布性能信息。