# 纯黑图对应其他模态的强度恢复核验

本次更新（2026-10-08）：118帧强度已重建并完成模型建议，148帧不可恢复黑图已退出后续训练/标注。**当前修正包为8,693帧**，并另交118帧专题复查包，见[本次交付说明](clean_intensity_review.md)。下文1,716帧训练、8,806帧预测与三轮稳定性属于保留的历史口径。


核验日期：2026-10-08，北京时间。依据[上一轮黑图来源审计](black_image_source_analysis.md)，继续检查同帧点云、其他处理版本、原始栅格和归档，而非仅检查当前帧清单。

**最新修正包的113张黑色主图没有找到可用于恢复空间纹理的同帧强度数据；这批图仍应使用已核验的同坐标深度显示。另一批2023_10_7的118张全黑原始强度YAML则可以从PCD恢复，已经逐帧验证。**

## 搜索与核验范围

针对148张黑色主图，重新核对当前数据目录的27,310个文件及既有归档目录表的24,612个条目。当前文件路径集合、文件大小与目录表一致。全目录按完整采集时间戳检索，不限原目录，也没有只按`xyz`/`xyzi`文件名判断强度是否存在。

匹配451个磁盘候选、442个归档条目，其中：

- 157份磁盘PCD：148份原帧点云、8份跨目录副本、1份全零帧的另一目录副本。
- 148份归档PCD：147份位于`2024_10_24.tar.gz`，1份位于`2025_3_31/3/point_2025_3_31.zip`。
- 同帧深度PNG及RGB各147份磁盘文件，各147份归档副本。
- 没有找到同帧`amplitude`、`intensity`或`reflectivity`栅格文件。

157份PCD头部字段均仅为`x y z intensity`，没有额外的振幅/反射强度字段。磁盘PCD重新计算SHA-256，与上一轮逐帧全量解析的原点云一致；归档442个匹配条目重新逐条读取并计算哈希，全部与磁盘内容一致。归档流式读取，没有复制大规模原始数据。

本次未取得数据目录之外的新采集备份或未关联日志的相机原始流。结论限定为现有、可以确认同帧身份的数据，不能把其他时间戳或未配准数据当作恢复来源。

## 能否恢复强度

| 对象 | 数量 | 同帧强度核验 | 结论 |
|---|---:|---|---|
| `2024_10_24`黑色主图 | 147（剩余包113） | 原点云、副本及归档内容一致，强度全为1 | 可还原全1数值矩阵，无法恢复有空间纹理的强度图 |
| `2025_3_31/31-03-2025_18-25-18#3` | 1 | 原点云、另一目录副本及ZIP点云一致，XYZI全0 | 当前数据没有可恢复的有效强度或深度 |
| `2023_10_7`全黑强度YAML | 118 | 同帧PCD保留变化的强度，原生224×172网格 | 可以恢复，118/118逐帧通过 |

### 2024_10_24：有字段，但数据已无强度纹理

这些PCD虽声明`intensity`，307,200个值却全部为1。全局固定缩放能把图显示为均匀灰色或白色，但只是显示亮度改变，不能恢复托盘纹理。其他同帧PCD也没有更丰富的强度值：

- `2024_10_29/FN/245mm/3000mm`中的8份候选与对应`2024_10_24`点云逐字节一致，不是另一份保留真实强度的采集。
- `2024_10_24.tar.gz`的147份同帧PCD也逐字节一致，归档没有保留另一种未覆盖的强度版本。
- 同帧原始PNG是深度，不是强度；RGB为1280×960，与点云原生640×480不同，未经配准不能直接用于原框坐标。

可以确定的是已有强度字段全部恒定；“上游填充占位值”仍是推断，没有代码/日志证明具体填充值的工具。

这147帧有可用、已核验对应关系的PCD深度及原生深度PNG，因此可以恢复可供标注的**深度视图**。不能把深度灰度图或RGB转灰度图称为恢复的ToF强度图，也不能将它们直接替换训练输入的强度通道。

### 2025_3_31：归档也没有挽回该帧

检查`3/point_cloud_xyzi_31-03-2025_18-25-18.pcd`、`3/18_25/point_cloud_xyzi_31-03-2025_18-25-18.pcd`及ZIP同帧点云，三者哈希相同。92,928个点的XYZ及强度均为0。用同组邻帧的强度填补会改变帧身份，没有足够运动/配准证据，因此未采用。

### 2023_10_7：已验证能重建118张强度图

逐帧完整读取118份原PCD，并核对源哈希。点云为有序224×172，每帧强度有非零动态范围，最大值范围约46.7974–67.6145，而对应YAML保存为全0。

恢复步骤为取PCD中按字段名读取的强度，按PCD原生`HEIGHT=172, WIDTH=224`组织网格，保留浮点强度及有效掩码；仅可视化PNG使用`log1p`和1%/99%分位缩放。重建后的118张预览与当前AnyLabeling导出的对应主图逐像素一致，说明当前流程已利用这些PCD避免了YAML保存错误。

另外保存3份示例PNG及原始浮点强度/有效掩码NPZ用于检查，没有重写原数据：

![全零YAML与PCD强度恢复对比](../outputs/black_intensity_recovery_check_20261008_v1/recoverable_intensity_comparison.png)

## 对黑色深度辅助图的补充说明

上一轮8,341张黑色深度辅助图对应未确认物理单位/投影的缺测策略，其中8,340帧已有非黑的强度主视图。可以用已有PCD强度做强度显示，但这不能恢复未确认的物理深度，也不应把强度PNG写入`.depth.png`冒充深度。

## 后续处理建议

对最新剩余包的113张恒定强度帧，优先切换为同坐标深度供人工检查，并继续复核同来源的34张历史人工空框负例。若未来取得原相机振幅帧或真实XYZI采集，须逐帧核验时间戳、网格及像素对应后再引入；当前无可用强度恢复来源。

本次不改动冻结标签、训练输入、模型、修正包和已有评估结果，仅生成核验记录及118帧的重建示例。

## 交付证据

- [148帧恢复资格逐帧CSV](../outputs/black_intensity_recovery_check_20261008_v1/frame_recovery_results.csv)
- [核验汇总](../outputs/black_intensity_recovery_check_20261008_v1/summary.json)
- [157份磁盘点云及其他模态核验](../outputs/black_intensity_recovery_check_20261008_v1/disk_candidate_checks.json)
- [归档442条候选的内容哈希核验](../outputs/black_intensity_recovery_check_20261008_v1/archive_candidate_checks.json)
- [可恢复118张原始黑YAML的PCD及强度统计](../outputs/black_intensity_recovery_check_20261008_v1/recoverable_118_raw_intensity_yaml_frames.json)
- [重建示例目录](../outputs/black_intensity_recovery_check_20261008_v1/recoverable_intensity_examples)

同帧替代源搜索脚本：[check_black_intensity_recovery.py](../scripts/check_black_intensity_recovery.py)。本次脚本实际执行成功并通过语法检查；若后续目录或同帧点云内容变化，会拒绝沿用旧审计结论，要求重新读取并验证。
