# 托盘位姿数据集（pallet_pose_dataset_v2；部分位姿监督）

来源：2026_10_17.zip；原检测集保持不变。本包独立构建，不训练模型、不修改当前活动检测数据入口。

## 数量

```json
{
  "archive_members": 743,
  "pointcloud_files": 705,
  "declared_raw_clouds": 566,
  "declared_derived_clouds": 139,
  "source_gt_tables": 34,
  "gt_manifest_samples": 328,
  "source_label_kinds": {
    "no_usable_gt": 75,
    "reference_xyz_normal": 45,
    "planar_xy_theta": 208
  },
  "all_cloud_exact_overlap_files": 150,
  "all_cloud_exact_unique_formal_frames": 150,
  "manifest_overlap_kinds": {
    "sha256_exact": 147,
    "not_in_formal_dataset": 133,
    "same_timestamp_not_equivalent": 3,
    "ordered_xyz_equal_intensity_differs": 43,
    "missing_pcd": 2
  },
  "manifest_verified_overlapping_samples": 190,
  "subsets": {
    "quarantine": 98,
    "overlap": 154,
    "archive_only": 76
  },
  "quarantine_reasons": {
    "no_usable_gt": 75,
    "ambiguous_multiple_boxes": 8,
    "sample_identity_not_proven": 3,
    "source_gt_conflict_requires_human_resolution": 12,
    "conflicting_rows_in_authoritative_table": 1,
    "formal_negative_conflicts_with_pose": 1,
    "missing_pcd": 2
  },
  "exported_examples": 230,
  "overlap_split_counts": {
    "train": 103,
    "test": 49,
    "val": 2
  },
  "overlap_task_split_counts": {
    "planar_xy_theta": {
      "train": 65,
      "test": 49,
      "val": 2
    },
    "reference_xyz_normal": {
      "train": 38
    }
  },
  "archive_only_task_counts": {
    "planar_xy_theta": 76
  },
  "authoritative_table_index_corrections": 1,
  "six_dof_examples": 0,
  "normalization_fitted": false,
  "training_started": false,
  "original_detection_labels_modified": false,
  "human_review_database_accessed": false
}
```

## 使用与边界

- `indices/overlap/planar_xy_theta/train|val|test.jsonl`：与正式检测集核验重叠、唯一人工框、无冲突的x/y/theta监督。
- `indices/overlap/reference_xyz_normal/`：原表中的参考点XYZ和法向量监督；与平面位姿分开使用。法向量不能确定绕法线的旋转，不能当完整6D姿态。
- `indices/archive_only/`：有明确GT但未证实属于当前正式集的扩展样本。无检测框、split=unassigned；未确认完整目标/采集组划分前，不自动进入训练或测试。
- `audit/quarantine.jsonl`：全部排除原因、冲突原值和来源引用。无GT不等于负例，多框不擅自绑定其中一框，缺失PCD不猜测对应文件。
- 每例有原生PCD、float32 `points_xyzi`（不删点/不改变顺序）、有效掩码和源点索引；重叠例另有原PNG、四通道sensor NPZ和 `pixel_to_source_index`。原PNG可经过180°方向校正；PCD未旋转，映射显式记录，不给GT角度擅加180°。
- 标签见每例JSON及 `annotations.jsonl`，缺失维度为null，`supervision_mask`控制损失。缺少z/roll/pitch时不填0；不导出虚构四元数/刚体变换或YOLO人体关键点标签。
- 权威原表优先于派生CSV索引；索引的法向量科学计数法损坏时，只在原表同一样本明确数值无歧义且各列一致时恢复，并记录index_correction与索引原值。真实GT冲突不自动裁决。
- `x_gt/y_gt/theta_d_gt`仅来自明确GT列，不读取x/y/theta、ICP输出或theta_d_convert_gt作为真值。单位按来源包为m/degree；点云原单位保留，只有原正式政策已有核验时才给scale_to_m。
- 参考系、目标参考点和角度方向保持来源语义，尚无统一传感器→机器人外参，不声称所有表已统一到同一个机器人坐标系，也不默认位置就是几何中心。用于跨域绝对位姿前须补充标定和定义。
- 原划分完整继承，没有为凑比例把val/test迁入train；只有一个框时按帧级唯一目标关联，仍需注意人工GT是否针对该目标的物理参考点。
- archive中的同名点云包含裁剪/分割/强度修改版本；只有SHA-256相同或逐点有序XYZ与VIEWPOINT完全相同才认定重叠。强度不同时保留正式集输入，记录差异，不覆盖输入。

## 核验

`sha256sum -c checksums.sha256`；或 `.venv/bin/python -m pallet.pose_dataset verify --dataset 解压目录`。
完整输入/逐表逐行证据见provenance和audit。CSV可直接在Excel中查看重叠和排除清单。
