# 托盘叉取面点云与掩膜提取报告

已处理 **10,374 帧、12,344 个人工托盘框**，生成 **58,529 个叉取面候选**。
原始检测标签和划分未改写；所有新掩膜是未经人工复核的自动派生标注。

## 结果入口

- [离线图像与可旋转点云图册](gallery.html)
- [逐目标CSV](targets.csv)、[逐面CSV](faces.csv)、[完整目标记录](targets.jsonl)
- [复核清单](review_queue.jsonl)、[逐帧溯源](frames.jsonl)、[统计JSON](summary.json)
- COCO RLE：`annotations/faces_{train,val,test}.json`；逐托盘联合掩膜：`annotations/pallets_{train,val,test}.json`。
- 完整点云：`clouds/`；二值掩膜：`masks/`；面编号图：`instances/`；冲突像素：`conflicts/`。

## 处理状态

| 项目 | 数量 |
|---|---:|
| 人工确认无托盘的原负例 | 263 |
| 有候选掩膜的托盘目标 | 12303 |
| 尚无可用叉取面掩膜的托盘目标 | 41 |
| 仅作诊断的平面 | 62535 |
| 识别为孔内或后层背景的平面 | 6719 |
| 不确定归属的重叠像素 | 185585 |
| 选中面实测点 | 27,670,574 |
| 所有框内有效点记录（重叠框可重复） | 72,528,514 |
| 重建强度图 | 118 |
| 180°校正图 | 300 |

单位状态：`{"inferred": 7422, "verified": 4920, "unknown": 2}`。
已换算到毫米的候选面，其逐面P95残差的中位数为 **5.815 mm**。
残差只描述几何拟合，不证明这个面一定是可叉取面。

| 配置域 | 帧 | 托盘框 | 无掩膜目标 |
|---|---:|---:|---:|
| 176x132_unverified | 51 | 51 | 0 |
| 224x172_fov_55_45 | 686 | 735 | 0 |
| 240x96_unverified | 300 | 295 | 0 |
| 352x264_fov_40_30 | 66 | 130 | 0 |
| 352x264_fov_55_40 | 3884 | 4972 | 4 |
| 352x264_unverified | 2330 | 2819 | 19 |
| 640x480_fov_65_50 | 415 | 415 | 0 |
| 640x480_fov_80_60 | 2642 | 2927 | 18 |

## 方法与边界

读取原始PCD，按冻结网格恢复排列，通过原生强度与浮点传感器张量核验逐像素对应。
180°校正只重排点索引，XYZ保留原坐标。点云不因强度为零而删除有效XYZ。
不使用SAM3掩膜或旧采样点云裁定叉取面。

使用8邻域、局部点间距与法向约束聚类；法向来自排除三维跳变的5×5邻域PCA，XYZ不平滑或替换。
固定种子的RANSAC提议平面，SVD在完整内点上精修。
默认邻接距离为点间距3倍，法向夹角25°；平面容差为点间距0.5倍，已知尺度时限制2–20 mm。
最终面至少32点。跨开口共面片段可以合并，托盘之间不合并。
参考：[PCL区域生长](https://pointclouds.org/documentation/tutorials/region_growing_segmentation.html)、
[PCL平面拟合](https://pointclouds.org/documentation/tutorials/planar_segmentation.html)。

共面片段的凸包只作为判定后层背景的二维支撑，**不填充输出掩膜**。
输出像素来自原始实测点；保留叉孔、遮挡及缺测空洞。可能的顶面/地面保留为诊断，
该图像方向规则不是已标定的重力方向。斜视、非平面、细小结构及深度边缘噪声可能使提取不足。
无法区分的叉取面身份进入复核；所有目标仍记录 `forkability_not_confirmed`。

训练集256帧进行了容差±25%敏感性试跑：
`{"comparisons": 570, "mean_mask_iou": 0.6462582902253847, "below_0_85": 524}`。
这属于参数敏感性，不是人工参考准确率，也不是检测AP。
未进行分割模型训练或最终测试评分。

## 使用标注

`cloud.npz`字段：`xyz_raw[N,3]`、`intensity[N]`、`uv[N,2]`（u/v原图整数索引）、
`source_point_index[N]`、`parent_box_index[N]`、`face_id[N]`、`diagnostic_plane_id[N]`。
`face_id>0`对应同帧面编号；0为未选中点，-1为归属冲突。强度缺失可为NaN，不改变有效XYZ资格。
`plane_raw`对应原始XYZ单位，`plane`使用该面记录的`geometry_units`。
编号图0背景，其他值对应逐面记录；掩膜为0/255，不按类别填满托盘框。

所有新分割记录设 `proposal_only=true`、`mask_human_reviewed=false`。
正例的分割训练资格均为false，必须完成掩膜复核后建立新快照；无掩膜正例不能当作负例。
原人工负例独立保留，不代表生成的叉取面已获人工确认。

打开图册可筛选划分、配置域及未解决状态，查看原图、叠图和点云；点云预览进行了显示采样，
完整结果以NPZ为准。所有文件使用相对路径，包内不含原始PCD或历史模型。

验证结果见 `validation.json`，校验命令：`sha256sum -c checksums.sha256`。

## 提取质量与复核说明

58,529个结果是**几何面片候选**，不能解释为真实叉取面的数量。
同一个实际面可能被噪声、非平面结构或保守阈值分成多个片段；需要人工合并或删除。
逐托盘联合掩膜已经将本托盘选中的面片取并集，保持原有孔洞。

全部12,344个托盘目标都列入复核清单，包括
41个没有可用掩膜的目标。
点云读取和映射成功不等于叉取面身份已确认；未解决目标仍保留其人工托盘框。

训练试跑覆盖256帧、285个目标，只包含有正例训练帧的三种网格。
240×96和176×132没有正例训练帧，已在配置冻结后补做源数据对应检查，并在全量阶段处理；
这些检查没有用于模型、阈值或结构选择，也没有进行最终测试评分。

默认容差±25%下的570次比较，平均联合掩膜IoU为
0.6463，
其中524次低于0.85。
该指标显示**参数敏感性较高**，不能作为掩膜正确率或标注收敛的依据。
请优先复核叉孔背景、薄横梁、堆叠边界、顶面/地面混入以及重叠框冲突。

显示字体和文档完善未改变PNG掩膜、点云、COCO或目标/面记录；原始几何源码快照保持冻结。
