跳到正文

比较安装布局 ​

这项操作比较同一批目标在不同安装布局下,能否找到满足运动学与静态碰撞条件的姿态。它不运行物理抓放;覆盖比例不是任务成功率或路径安全证明。

前提:已取得模型资产,安装基础环境,并能使用规划后端。先选择 experiments/workspace_layouts.yaml 中要比较的布局、目标与预算。

静态布局 ​

先只准备输入,检查配置和预算:

sh
uv run pride workspace compare experiments/workspace_layouts.yaml --prepare-only

核对目标集合、种子、各布局和求解预算。确认比较只改变要研究的安装变量,再运行完整比较:

sh
uv run pride workspace compare experiments/workspace_layouts.yaml

默认创建新的结果目录;需要自己指定时用 --output,目标目录不能已存在。保留终端输出的实际路径。

阅读报告 ​

先打开结果目录里的 report.md,查看各区域覆盖比例和布局间得失。再核对 experiment.json 的完成状态、目标哈希、模型哈希、种子与预算。准备目录或部分结果不能当作完整比较。

either 表示至少一臂找到解;both_independently 表示两臂分别找到解,但可以是两幅不同的完整姿态,不能据此推断双臂同时作业。

某个目标未找到解时,先看预算、容差与碰撞诊断。增加预算可能改变结果,新的对照必须对所有布局使用一致预算。跨种子范围不是置信区间。

公平比较与判据 ​

  • 布局是相对配准 CAD 的增量。比较时只改变选定布局变量,固定目标位姿与朝向、完整参考关节、碰撞规则、种子、attempts 和 max_iterations。
  • 当前规划器使用 Pinocchio/MPLib CLIK;执行请求只接受当前迭代预算。历史 max_nfev 是另一种预算含义,不能拿其数值直接比较新运行。
  • either 表示至少一臂找到解;both_independently 表示分别找到解,两幅完整关节姿态可以不同,不证明双臂同时作业或交接。
  • 按区域先算目标覆盖比例,再按任务权重汇总。gained / lost / retained / unresolved 按相同目标、种子与预算逐项配对;跨种子范围不是置信区间。
  • not_found 包含求解容差未满足或候选碰撞等情况,只说明本预算没有找到可接受解。关节余量不是碰撞距离,候选碰撞次数不是实际碰撞概率。

模型边界 ​

厂家链与 CAD 的几何配准、TCP 偏置、末端安装和相机位置包含明确假设。保留厂家限位,参考姿态可与原 CAD 超限姿态不同;不能通过放宽限位消除差异。具体假设随模型清单和来源记录保存。

碰撞模型包括双臂、双手、桌体、机架和相机。生成器按独立实体构建凸包;退化实体采用记录在模型清单中的保守盒子。SRDF 的刚性安装等豁免不证明安装件无干涉或新支架可制造。候选接受条件由求解实现(backends/planning/src/pride_planning/workspace.py)定义;静态无碰撞不证明路径可执行。

产物与验证 ​

单模型目录包含 URDF、SRDF、模型清单、worker 日志和结果。实验目录另有 experiment.json、report.md 与各布局结果;清单冻结目标、配置、种子、预算、代码来源和哈希。模型引用的原始资产与目录关系必须一起保留。

准备、失败与完整结果分别标识;准备目录或部分结果不能作为完整比较。读取复用 workspace_experiment.load_result 与 verify_model 校验。复现比较输入、状态、解和诊断;墙钟时间本身不是确定性指标。

检查选择见验证指南的 planning、workspace 与 kinematics 范围。协议检查不验证浏览器画面。能力边界见当前状态。