# “未知单位”点云的数值与距离核查

## 范围与定义

- v3评测对应冻结研究标签：823个未知单位目标（572 train / 130 val / 121 test），来自768帧。
- 正式数据中登记`scale_to_mm=null`的全集：6,879帧、7,424个原检测目标。
- 不读取或修改在线标注库，不改传感器单位登记，不重写任何PCD、标签、模型或已冻结实验。
- 每个解析文件重新核对原始PCD SHA-256。
- 数值有效点：XYZ均有限且至少一个分量绝对值大于`1e-8`。未凭数值猜测厂商特殊无效码。
- “含非零小数”按原文件声明的float32数值是否恰为整数判断，不等同于传感器测量精度。
- 距离同时检查原始X与`√(X²+Y²+Z²)`，阈值为**原始数值10**，不擅自写成10米。
- 原框ROI可能包含背景；人工选定面采用冻结时完整测量点索引，单独报告。场景每帧仅计一次，重叠目标框内的点可能重复计数。

## v3评测队列：完整核查结果

823个目标、768个源PCD均核验通过，全部为ASCII PCD，XYZ均声明`TYPE F`、`SIZE 4`，即float32。

### 是否全部是非整数小数？

不是严格全部，但绝大多数是。

冻结人工选定面共有494,602个有效实测点：

|分量|非整数值个数|整数值个数|其中为0|
|---|---:|---:|---:|
|X|494,581|21|0|
|Y|494,582|20|16|
|Z|494,602|0|0|

810/823个目标的全部选定点XYZ分量都是非整数；另外13个目标存在少量整数分量。
合法的Y=0坐标不等于无效点，原始全场景中的全零无效点另行剔除。

### 小数位是否每一位都有实际有效精度？

不能这样认定。代表原文值包括`0.63700002`、`0.72399998`、`1.8380001`。
在`352x264_fov_55_40`和`352x264_unverified`各抽取的一个完整代表文件中，
所有有效XYZ数值都能由“保留3位小数后转回float32”精确重现，长尾是浮点表示造成的，
不是额外的独立十进制精度。

`224x172_fov_55_45`代表文件不满足同一3位小数量化特征，保留更多数值小数位；
仍不能从这些位数推导测距精度或单位。上述量化检查是代表文件核验，不冒充整个域逐点量化证明。

### 目标距离是否超过10？

没有，按人工选定面和原框ROI两种定义都未发现。

|范围|每目标X中位数范围|每目标XYZ径向距离中位数范围|最大单点径向距离|距离>10的点数|
|---|---|---|---:|---:|
|冻结人工选定面|1.3492–2.6343|1.3957–2.7187|3.2839|0|
|原检测框全部有效点|1.5789–2.6519|1.6563–2.7567|6.7347|0|

但完整场景中有888个有效数值点的径向距离超过10，最大约29.9855。
这些点不在本次823个托盘的原框ROI内，不能据此宣称托盘目标距离超过10；
它们可能是背景或异常测量，需要另做传感器置信度检查才能判断物理含义。

## 正式全集完成后的补充结论

6,879帧、7,424个目标的全量核查已完成，所有源PCD哈希匹配。
此前823目标的结论不能不加区分扩展到全部“未知单位”：

- `240x96_unverified`有300帧、295个目标。300帧中全部数值有效XYZ均为整数，
  即使文件字段类型仍为F4；295个目标的原框距离中位数为557.383–1,542.491，全部超过10。
  数值形态更接近毫米级编码，但本核查不据此自动将比例设为0.001。
- 其他6,579帧、7,129个目标中，7,111个原框有有效点、18个没有有效点。
  有效目标的径向距离中位数为0.909–4.036，全部小于10。
  其中部分原框仍包含少量距离超过10的点（两个352×264域合计34点），
  所以“目标典型距离小于10”不等于“全体原框点没有超过10”。
- 用户确认已核查评测队列按米制解释：对那823目标，1原始单位=1米，属于用户确认，
  不是设备标定证据。历史实验和单位注册表尚未由本核查改写。
  240×96这类不同量级的采集配置不能混用同一米制比例，需要独立确认。

### 各域目标原框径向距离中位数范围（未换算的原始数值）

|域|帧数|目标数|有效目标的距离中位数范围|目标中位数>10|
|---|---:|---:|---|---:|
|176x132_unverified|51|51|2.478–2.507|0|
|224x172_fov_55_45|686|735|1.656–2.757|0|
|240x96_unverified|300|295|557.383–1,542.491|295|
|352x264_fov_40_30|66|130|1.664–2.103|0|
|352x264_fov_55_40|2,465|2,641|1.282–4.036|0|
|352x264_unverified|869|857|1.602–2.880|0|
|640x480_fov_80_60|2,442|2,715|0.909–3.727|0|

证据为`all_summary.json`的`domains`和`all_targets.jsonl`，不使用尚未确认的原始X作为所有传感器的统一前向距离。

## 证据与复现文件

全部结果输出到独立目录`outputs/pallet_pose_native_units_audit_v1/`：

- `benchmark_summary.json`、`benchmark_frames.jsonl`、`benchmark_targets.jsonl`：768帧/823目标的全量结果。
- `representative_decimal_grid_checks.json`：各域代表文件的小数量化检查及原始ASCII样例。
- `all_header_summary.json`：正式全集6,879份未知单位PCD头检查，全部ASCII、F4、点数与图像网格一致。
- `all_summary.json`、`all_frames.jsonl`、`all_targets.jsonl`：正式全集逐点/逐框核查结果；仅在全量核查成功后生成。

```bash
PYTHONDONTWRITEBYTECODE=1 OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 \
  .venv/bin/python scripts/audit_pose_native_units.py --scope benchmark
PYTHONDONTWRITEBYTECODE=1 OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 \
  .venv/bin/python scripts/audit_pose_native_units.py --scope all
```

数值集中于1–3且具有小数，并不自动构成“单位已验证为米”的证据。
后续若要变更单位资格，需要结合设备文档、采集程序与独立尺寸/距离锚点，另建可追溯核验记录。

## 2026-10-21后续用户确认（不改上述历史审计）

用户进一步要求所有位置统一米制，并在明确询问240×96量级例外后确认“原单位为毫米”。
位姿UI v12因此使用独立 `configs/pallet_pose_review_units_v1.json`：240×96原未知单位按0.001转米，
其余原未知单位按本次用户确认以米解释；原已登记比例保留。依据是用户确认，不声称新增厂商标定。
旧审计输出、单位未知实验和交付包保留；原PCD及正式源注册未原地改写。
单位归一化的新修订、转换日志及当前全量覆盖核验见 `outputs/pallet_pose_review_validation_v12/`。
