给机械臂套上泡泡膜Genesis 里用凸分解跑通 URDF 抓取仿真【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-world这是 Genesis通用机器人与具身 AI 仿真平台的凸分解实战教程。它帮你把 URDF、MJCF 模型里的非凸网格拆成一组凸包让碰撞检测不再拖垮帧率。适合第一次把复杂模型塞进物理仿真、被卡顿困扰的开发者。为什么需要它想象这样一个场景你下载了一个细节完整的咖啡杯 OBJ 模型扔进仿真里让机械臂去抓。结果两件事同时发生——第一步scene.step()卡了几十秒因为引擎要对几千个三角形做接触求解第二杯子边缘的钩子让机械臂指尖莫名其妙地滑开或者穿透因为非凸表面的接触点在每一步都在跳。Genesis 的默认策略是自动凸分解给刚体实体RigidEntity加进场景时convexify参数默认为True见genesis/options/morphs.py引擎先算整个网格的凸包如果凸包体积和原网格体积差得太多超过decompose_object_error_threshold默认 0.15就调用 CoACD 算法把网格切成多个凸块。你不用写一行分解代码但要理解它在做什么才能在参数不合适时救场。想亲眼看看分解结果给实体加一个vis_modecollision参数视角里显示的就是碰撞网格而不是外观网格——examples/rigid/convex_decomposition.py就是这么展示一排水杯、甜甜圈被拆成什么形状的。先建立心智模型把凸分解理解成给石头套泡泡膜你没法直接对一块不规则石头算精确的接触力但可以用几个泡泡凸包把石头表面贴住。泡泡是光滑凸的物理引擎对凸体 vs 凸体求接触又快又稳。贴一个泡泡不够贴合就贴十个。Genesis 里的分工是这样的两个关键机制值得记住。第一先试单凸包如果网格本身近似凸比如一个圆柱杆凸包误差小于阈值就直接用一个省掉最贵的分解步骤。第二磁盘缓存分解结果按网格顶点和参数存成.cvx文件genesis/utils/mesh.py里的get_cvx_cache同一个资产被场景复用几十次时只有第一次付分解的钱。动手从零跑通1. 安装并初始化 Genesispip install genesis-simimport genesis as gs gs.init(backendgs.gpu, precision32, seed0) # CPU 换 gs.cpu scene gs.Scene(rigid_optionsgs.options.RigidOptions(dt0.01), show_viewerTrue)这一步创建仿真后端和一个带刚体求解器的场景dt0.01表示每步推进 10 毫秒。2. 加载一个非凸模型并看它的碰撞网格scene.add_entity( gs.morphs.Mesh(filemeshes/tank.obj, scale5.0, fixedTrue), vis_modecollision, # 关键显示碰撞网格而非外观网格 )vis_modecollision就是掀开外观看里面的开关跑起来你会看到坦克被拆成了几块凸的泡泡。3. 用阈值参数控制分解行为mug gs.morphs.URDF( filemy_mug.urdf, convexifyTrue, # 刚体默认就是 True decompose_object_error_threshold0.15, # 凸包体积误差超过 15% 才分解 ) scene.add_entity(mug, vis_modecollision)三个参数各管一件事convexify决定要不要凸处理decompose_object_error_threshold决定普通物体的分解灵敏度0.0 强制分解float(inf)彻底禁用decompose_robot_error_threshold只针对多关节机器人默认inf即默认不分解因为机器人通常按 link 自带简单碰撞体一般不用动。4. 调 CoACD 分解算法本身的旋钮mug gs.morphs.URDF( filemy_mug.urdf, coacd_optionsgs.options.CoacdOptions( threshold0.1, # 主精度参数见下表 max_convex_hull12, ), )coacd_options只在真的触发分解时生效。注意它内部用 MCTS蒙特卡洛树搜索挑切割面所以分解过程本身要跑一会儿这是首次加载慢的正常现象。5. 跑起来scene.build() for _ in range(2000): scene.step()看窗口凸块贴合得紧不紧、物体是稳稳落下还是抖动穿透答案都写在碰撞网格里。完整可运行版本直接看examples/rigid/convex_decomposition.py。参数调优速查表这些参数都在genesis/options/morphs.py和genesis/options/misc.py里默认值直接取自源码。参数名默认值作用调整建议convexify刚体为True是否对实体做凸包/分解处理纯装饰物设False可省掉全部计算decompose_object_error_threshold0.15普通物体凸包体积误差超过该比例才触发分解物体总被一个大方块包住 → 调小如0.05加载慢 → 调大或设infdecompose_robot_error_thresholdinf同上但只管多关节机器人一般保持不动机器人碰撞体多在 URDF 里显式定义CoacdOptions.threshold0.1分解精度主参数源码注释写明阈值减半约使凸包数量翻倍CoacdOptions.max_convex_hull-1不限凸包数量上限复杂物体建议给个上限如 12防止爆炸CoacdOptions.max_ch_vertex256单个凸包最多顶点数越大越贴合内存和求解开销越大decimate_face_num500碰撞网格减面目标面数高模拖慢加载时可放心调低CoacdOptions.pcaFalse是否启用 PCA 预处理别开上游 CoACD 有 bug设True会直接报错踩坑现场现象换个 scale 重新加载同一个模型又等了半天分解。原因是分解缓存按归一化顶点 面 coacd 参数做 key但如果你改的只是场景里的摆放位姿缓存本该命中。真正失效的常见原因是你悄悄改了某个CoacdOptions字段——参数参与 key变了就重新算。想复用结果就保持参数一致分解结果存成.cvx文件后同目录下的重复实体会直接读缓存。现象杯子抓的时候指尖老从把手上滑过像是穿模。这是凸包太粗的典型症状把手是个凹陷结构一个凸包直接把它抹平了碰撞体上没有把手。修复方式是把decompose_object_error_threshold调到0.0强制分解或把CoacdOptions.threshold从0.1降到0.05再用vis_modecollision确认把手位置出现了独立的凸块。现象物体加载出来形状歪了或者分解结果不对称。先检查CoacdOptions.pca是不是被设成了True——Genesis 会直接抛异常拒绝因为上游 CoACD 的 PCA 变换没有逆变换回分解结果源码里有明确的 FIXME 注释。另外确认网格法线朝向一致genesis/utils/mesh.py里对非一致 winding 的网格会拒绝分解并给出报错这种情况得先回 DCC 工具修法线。延伸去处示例代码examples/rigid/convex_decomposition.py带-v参数可开可视化-g切 GPU 后端非凸网格对照实验examples/rigid/nonconvex_mesh.py凸分解核心实现genesis/utils/mesh.pyconvex_decompose与postprocess_collision_geoms两个函数参数定义genesis/options/morphs.py实体级参数与 genesis/options/misc.pyCoacdOptions刚体实体消费这些参数的入口genesis/engine/entities/rigid_entity/rigid_entity.py项目主文档README.md【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-world创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考