# 2026_10_17 — 托盘检测 GT 数据集打包

打包时间：2026-10-17　位置：`M:\Tutor\Doctor\Document\Corp\2026_10\2026_10_17`
来源：`M:\Tutor\Doctor\Document\Corp` 全库检索结果
**只复制，未移动或删除任何原始文件。**

> 归档版本：`Corp\2026_10\2026_10_17.zip` —— 743 个条目 / **0.50 GB**（原 1.96 GB，压缩率 25.6%），
> 归档内 CRC 全量校验通过。校验值（md5 / sha256）见同目录 `2026_10_17.zip.sha256`。
> 解压后得到 `2026_10_17\` 目录，结构与下表一致。

---

## 一、内容

| 目录 / 文件 | 内容 | 数量 | 体积 |
|---|---|---|---|
| `点云\` | 具备 GT 标注的点云，按内容去重 | **705 个 `.pcd`**（原始 566 + 派生输出 139） | 1.96 GB |
| `GT表格\` | 权威（原始）GT 标注表 | **34 份**（.xlsx 30 / .xls 3 / .csv 1） | 2.79 MB |
| `gt_manifest.csv` | **主索引**：每个样本一行，点云 ↔ GT 数值 ↔ 来源表 | 328 行 | — |
| `清单_点云.csv` | 每个点云：打包路径 / 原路径 / 字节 / md5 / 是否派生 / 磁盘同内容份数 | 705 行 | — |
| `清单_GT表格.csv` | 每份表格：打包路径 / 原路径 / 字节 / md5 / mtime / ctime | 34 行 | — |
| `README.md` | 本说明 | — | — |

两个子目录都**保留原始相对路径**，例如：

```
点云\2024_11\2024_11_29\point_cloud_xyzi_29-11-2024_07-04-42.pcd
GT表格\2024_11\2024_11_29\result_2024_11_29_none_rectified.xlsx
```

---

## 二、口径

1. **GT 表格 = 权威（原始）表**：每个样本只保留一份来源表 —— 优先「同期标注表」（表格所在日期目录与点云采集日相差 ≤1 天），无同期表时取 mtime 最早的一份；同一内容的重复副本（md5 相同）只取一份。
   - 因此未收录：派生/再标注表、纯副本表，以及 `2023_12_6\background\标定参数.xlsx`（它标注的是距离档位，不是点云样本）。
2. **点云去重**：按文件内容 md5 去重，同一份点云被复制到多个日期目录时只保留一份（代表优先取与采集日期同目录的那份）。`清单_点云.csv` 的 `same_content_copies_on_disk` 列记录了它在磁盘上原本有几份。
3. **派生输出**：文件名在时间戳之后带 `_seg` / `_normal` 后缀、或位于 `seg\`、`normal\` 目录的，判为派生输出（共 139 个，仅 8.85 MB），在 `清单_点云.csv` 中以 `is_derived_output=Y` 标记。
4. **角度口径**：GT 角度一律取 `theta_d_gt`。`theta_d_convert_gt` 列存在相差 180° 的两种写法（68 份表内部混用），未纳入 manifest。

---

## 三、`gt_manifest.csv` 字段

| 字段 | 说明 |
|---|---|
| `sample_key` | 样本键（点云采集时间戳 `T:YYYYMMDDHHMMSS`，或点云名） |
| `capture_time` | 点云采集时间 |
| `pcd_packed` / `pcd_original` | 打包内路径 / 在原库中的路径 |
| `pcd_bytes` / `pcd_md5` | 点云大小 / md5（前 12 位） |
| `x_gt` `y_gt` `z_gt` `theta_d_gt` `roll_gt` `pitch_gt` `yaw_gt` `normal_gt` | 权威 GT 数值 |
| `authoritative_table` | 该 GT 的来源表（打包内路径同 `GT表格\` 下） |
| `same_day` / `days_delta` | 是否同期标注 / 表格日期与采集日期相差天数 |
| `n_tables_with_gt` | 全库共有多少份表标注了该样本 |
| `n_value_variants` | 这些表给出了几种不同的 GT 取值（按容差聚合：位置 1e-4 m、角度 1e-3°） |
| `has_conflict` | **Y = 存在真值冲突**（共 12 个样本） |
| `other_gt_variants` | 其它取值组，供人工裁决 |

---

## 四、使用提示

- **328 个样本**中：195 个有同期标注表；**12 个样本存在 GT 冲突**（`has_conflict=Y`），使用前需按 `other_gt_variants` 人工裁决；**2 个样本只有标注、磁盘上没有点云**（`pcd_packed` 为空，均来自 `2025_4_15` 的表格）。
- 按 GT 语义：253 个样本带 `x_gt`/`y_gt`/`theta_d_gt` 基准真值，可直接用于精度评估；其余 75 个只有相对位移（Δx/Δy/θ）或参考位姿等其它口径。
- 冲突与原始表判定的完整论证见《点云样本GT标注冲突核查报告.md》；表格识别规则见《全库表格文件位姿真值标注检索报告.md》。

---

## 五、复现

```
python gt_pack.py            # 生成/更新本目录（已存在且大小一致的文件会跳过，可重复执行）
python gt_pack_verify.py     # 校验：文件数、体积、逐文件大小比对、抽样 md5
python gt_zip.py 6           # 归档为 ..\2026_10_17.zip（级别 6），并做 CRC 全量校验
```

脚本位置：`M:\Tutor\Doctor\Document\Corp\gt_pack.py`、`gt_pack_verify.py`、`gt_zip.py`
依赖：同目录 `gt_scan.py` 产出的 `gt_scan.json` 与冲突核查产出的 `gtc_records.json`（位于 `C:\Users\Phineas\AppData\Local\Temp\opencode\`）
