主题
比较安装布局
这项操作比较同一批目标在不同安装布局下,能否找到满足运动学与静态碰撞条件的姿态。它不运行物理抓放;覆盖比例不是任务成功率或路径安全证明。
前提:已取得模型资产,安装基础环境,并能使用规划后端。先选择 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 范围。协议检查不验证浏览器画面。能力边界见当前状态。