# 托盘论文方法最新标注对比 v5

## 目的与数据

独立目录：`outputs/pallet_pose_paper_benchmark_v5/`，不修改v4、在线人工库、正式划分或机器建议。
2026-10-21T16:12:18Z冻结3,609个保存目标、7,672条事件，校验后3,593条有效研究草稿：train 1,767 / val 667 / test 1,159；118个train采集组三折。
6个删除目标与10个缺少标尺/位姿的目标隔离，所有有效目标原框预处理成功。

单位严格绑定`configs/pallet_pose_review_units_v1.json`：已有注册比例保留，未知默认米，240×96原单位毫米乘0.001。当前有效快照没有240×96目标。该授权不是设备标定或位姿确认。

输入为原检测框内的有效实测XYZ（神经模型另有强度、有效性与自动像素特征）；不使用人工多边形、选面、标尺、GT、目标ID、采集组ID作为推理输入。
输出统一叉取面宽度中心XY与叉入方向θ；未标注自由度保持未知，全部`robot_command_eligible=false`。

## 论文适配范围：不能写成作者原实现复现

1. **Xiao 2017**，DOI `10.1177/1729881417737799`：有序点云局部法向/像素邻接区域生长，筛选近前向竖直平面，平面局部占据栅格的实体/空洞匹配与滑动中心搜索。本轮未取得可读出版社全文，依据可核对的方法概要独立实现；不宣称与原文模板相似度及所有启发式等价。
2. **PILA 2021**，DOI `10.1109/CACRE52464.2021.9501390`：仅固定原框几何后端；点云前面RANSAC、分层边界与直线拟合、宽度中心和方向。未训练RGB检测器；原文三角形中心规则未完整核实，采用边界线最小二乘，属于适配，不是逐公式复现。
3. **Shao 2023 AGWF**，DOI `10.3390/s23031217`：可核对全文保存在`paper_sources/`。测量点体素降采样、ISS逆距协方差/特征值比/NMS；平均最近邻距离dp，在[dp,2dp]五半径中选最小特征熵；Gaussian权重SPFH聚合；SAC-IA抽样对应与Huber评价；SVD刚体ICP。遵循§2.2–2.4，仍非作者代码，工程差异见下。
4. **FPFH消融**：相同ISS、模板、对应、ICP；固定5dp半径与逆距离权重，不作为另一篇论文，也不宣称与PCL官方FPFH逐元素等价。

### AGWF与模板工程差异

- ROI与自动前面附近±0.12m深度带、自动测量高度带替代原文完整场景通路；体素0.015m、最多1,024点，避免域间密度差异导致失控耗时。
- 局部法向使用16近邻、朝向传感器；ISS显著性半径6dp、非极大值4dp、特征值比0.975、最多96点。
- 最小邻域4点；不足时选2dp而不是补伪造点。Gaussian sigma下限1e-6防止除零；无充分ISS特征直接报告失败，无偷偷使用GT初始化。
- 三个非共线样本、最近5个描述子候选、128次采样；候选距离至少0.03m；明确+X叉向、+Z向上先验，不是轴向标定。
- ICP最多40轮、0.08m对应门限、至少12对应、最终内点率至少0.3；不收敛/方向不兼容计失败。
- 模板来自各折原train的自动原框点云，训练位姿只定义模板参考系。最多6个几何尺寸多样模板，在线根据点云尺寸选2个候选，不根据目标ID/采集组/GT路由。
- 原论文单个标准托盘模板扩展为train模板库；没有精确CAD规格，不把人工标尺宽度作为在线输入。
- 模板占据图32×12；平面阈值0.008/0.015/0.025m只在原train三折内选，配准固定0.015m。

## 学习对照

复用**未修改**v4训练引擎和固定官方PointNeXt骨干，在进程内重绑定新ROOT/config/load，绝不重写v4目录。
512点、3个确定性排列，batch32、240轮、种子42/142/242、原train组三折；按CV选早停，9折最优epoch中位数决定全train种子42重拟合轮数。
保留真正末轮、AdamW状态、各折样本绑定和GPU UUID。
仅使用`GPU-3315c096-fef4-7350-483a-7c5f5ca2b619`、`GPU-09ed84c8-4dee-efc0-dc1d-deda5177e4e8`，不调度3090。
另外用v4冻结`pointnext/long_b32`权重在新标签上迁移复测，单列，不冒充新训练。

CPU与学习参数均冻结在`selection_frozen.json`之后才计算任何val/test指标；此前test已看过，不是首次盲测。

## 指标与失败

XY误差mm、方向误差°：均值/中位数/P90/P95；50mm/5°联合达标数/完整分母；覆盖；原生失败原因；共同几何回退；相对几何挽回/新增退化；共同输出位置差；域/组分解。
综合分为位置误差/自动宽度/0.05+方向误差/5，失败100，组等权。描述性95%区间以采集组配对bootstrap，不视为独立显著性或实机证据。
不同覆盖的条件均值不能直接比较，报告同时给原生、共同回退和共同输出差值。
配准的记录耗时含共享双描述子准备与文件读取，不能用于单算法实时性能排名；神经延迟未测则保留null，不能补0。

## 执行

```bash
env PYTHONDONTWRITEBYTECODE=1 OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 \
  .venv/bin/python -u scripts/run_pose_paper_benchmark_v5.py
```

已冻结目录只能用相同配置恢复；不同配置使用新版本目录，不覆盖。
驱动在`logs/`写逐任务日志，`run_status.json`记录运行状态。可从`last.pt`恢复，已有完成折不重训。
原生CPU CV独立启动时驱动传`--skip-cpu-cv`，要求CPU选择文件在全局冻结时已经存在，否则明确失败而不查看holdout。
临时依赖在`/tmp/opencode/pallet_paper_tools`及已有`/tmp/opencode/pose_benchmark_small_deps`，不改项目venv或历史依赖。

## 交付与验收

- `final_results.json`、`REPORT_zh.md`：汇总与限制。
- `report/index.html`：单文件离线中文手机布局、内嵌图像、表格排序、CSV/JSON下载。
- `report/target_metrics.csv`：全部逐目标结果。
- `templates/`、`paper_sources/`：来源、适配方法证据与模板来源/哈希。
- `pallet_pose_paper_comparison_v5.zip`、`delivery_manifest.json`：报告、源码、训练配置、模板及选定权重；不打包原始PCD或真实在线SQLite。
- `final_acceptance.json`：独立重算指标、20,768正式文件保护、PCD及旧包哈希、原人工事件前缀、按组模板无泄漏和ZIP成员校验。

浏览器验收使用匹配的Chromium 111与Playwright 1.32.1；旧Playwright配Chromium 131会在`file://`导航挂起，不能将该超时误记为报告失败或通过。
验证链路已在`/tmp/opencode/pose_paper_v5_synthetic_browser_smoke/`合成页面上通过桌面/手机共10项检查；这仅证明验收程序可运行，不是实际实验报告的验收结果。最终仍须生成真实报告并通过`report_validation/validation.json`。

案例按事后类别确定性选择最多12个，包含改善、退化、失败、回退；不称随机或无偏代表。原强度图只画检测框，点云原始XY及中心差图等比例，不伪造相机标定投影。
当前研究标签具有几何初值偏倚，复现结果不证明独立物理精度或实机叉取成功率。
