Genesis URDF 凸分解指南非凸模型为何拖慢碰撞检测以及如何调参提速【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-worldGenesis 是面向机器人与具身智能学习的通用仿真平台。它的 URDF 凸分解机制会把非凸的碰撞网格自动拆成一组凸包并叠加磁盘与内存两级缓存让复杂刚体的碰撞检测保持高效与稳定。本文拆解这套机制的原理、核心实现与调参方法。 现象导入模型越精细仿真越先卡先说一个很常见的场景。我们把一段建模精细的机械臂、一个带把手的水杯或一个不规则的抓取物体拖进场景里。刚加载完画面还很顺可一旦这些物体和地面、彼此发生接触帧率就开始往下掉接触点一多求解器还会报警物体甚至自己原地发抖。问题通常不出在模型好不好看而出在它的几何形状。视觉上圆润流畅的凹面、凹槽、镂空结构恰恰是碰撞检测里最难算的东西。这类非凸网格如果原样交给物理引擎往往要付出三重代价接触计算量随顶点数攀升越细越慢凹面之间的接触不连续约束方程更难收敛高细节顶点数据长期占用显存。Genesis 针对这件事给出的核心手段就是URDF 凸分解把一个难判断的凹体换成几个好判断的凸体。 原理推演非凸网格把检测拖慢的三处成本非凸刚体场景Genesis 会在碰撞求解前把非凸碰撞网格拆解为一组凸包并用碰撞网格显示模式呈现结果。为什么非凸会慢我们把碰撞检测拆成两层看窄相Narrow Phase。Genesis 刚体求解器里的 GJK / EPA 一类算法本质上是为凸体对凸体设计的它们假设两个物体各是一个整体凸包这样才能用少量迭代逼近最近点。一旦其中一方是凹体单个凸包就无法代表它的全部接触关系必须把它拆成多个凸体再对每一对凸体分别跑一次检测。凹体越绕拆出的凸体越多两两组合的接触对就越密。约束求解。每一对凸体接触都会生成一组约束位置、法向、摩擦。接触对一多约束规模上升迭代求解的每一步都更贵。内存。高细节非凸网格的顶点、法向、边邻接数据都要常驻显存同一资产若被多次实例化这些开销还会成倍累加。凸分解的价值就在这里它把接触判断的对象从一个高维凹面降为若干低维凸体检测与求解的复杂度随之从随顶点数飙升变成随凸包数量线性增长。代价是凸包数量本身——数量越少越快但形状近似误差越大这也是后面调参的核心矛盾。 关键实现拆解CoACD 分解与两级缓存Genesis 把凸分解放在碰撞网格的后处理阶段入口在 genesis/utils/mesh.py。它由三块组成我们逐个看。用 CoACD 把非凸体切成凸包真正执行分解的是 genesis/utils/mesh.py 里的convex_decompose它调用 CoACD 算法把输入网格切成一串凸体convex hull / boxdef convex_decompose(mesh, coacd_options): # 缩放无关用归一化顶点做缓存键同一资产的不同缩放共用一条记录 mesh_scale float(np.linalg.norm(mesh.extents)) cache get_cvx_cache(mesh.vertices / mesh_scale, mesh.faces, coacd_options) loaded cache.load() if loaded is not None: # 命中磁盘缓存直接读 .cvx并按比例缩放回当前尺寸 ... # 未命中才真正跑一次 CoACD再把结果落盘 result coacd.run_coacd( coacd.Mesh(mesh.vertices, mesh.faces), thresholdcoacd_options.threshold, max_convex_hullcoacd_options.max_convex_hull, max_ch_vertexcoacd_options.max_ch_vertex, ... ) mesh_parts [trimesh.Trimesh(vs, fs) for vs, fs in result] cache.save({mesh_parts: mesh_parts, mesh_scale: mesh_scale}) return mesh_parts注意threshold这个参数它是控制精度的主旋钮。经验上把阈值减半拆出的凸包数量大约翻倍——更贴合形状但更耗内存与检测时间。两级缓存磁盘 .cvx 与内存 SizeCappedCache分解是添加文件型实体里最贵的开销之一同一资产若在场景里出现多次没必要算很多遍。Genesis 用两级缓存来摊薄# 磁盘级同一网格 同一组 CoACD 参数 - 一个 .cvx 文件跨进程复用 def get_cvx_cache(verts, faces, coacd_options): return MeshCache(get_cvx_cache_dir(), cvx, verts, faces, coacd_options.__dict__) # 内存级按 512 MiB 上限缓存已处理碰撞网格同资产多实例共享同一份几何 _COLLISION_GEOMS_CACHE SizeCappedCache(max_bytes512 * 1024 * 1024)磁盘级缓存以网格 全部 CoACD 参数为键把结果存成.cvx文件重启后依然能命中内存级缓存则按实际占用的几何字节数顶点面封顶保证少量大资产和大量小资产都被限制住而不是简单按条目数砍。两者叠加把重复分解的成本压到接近零。误差阈值能偷懒就不分解并非每个非凸网格都值得完整分解。genesis/utils/mesh.py 会先试算一个整体凸包用体积偏差判断这个网格够不够凸# 先取整体凸包看它和原网格的体积差有多大 cmesh trimesh.convex.convex_hull(tmesh) volume_err abs(cmesh.volume / abs(tmesh.volume) - 1.0) if volume_err decompose_error_threshold: # 偏差过大必须走完整 CoACD 分解 ...偏差小于阈值时直接用一个凸包就能近似省去整轮 CoACD只有凹得明显的网格才触发分解。这是一条很实用的快速路径——它让作者已手动拆成凸体的资产几乎零成本地跳过分解。 上手验证三步跑通加载—分解—仿真完整可运行的示例见 examples/rigid/其中convex_decomposition.py就演示了带vis_modecollision的碰撞网格显示。最小流程是import genesis as gs gs.init(backendgs.gpu, precision32, seed0) scene gs.Scene( rigid_optionsgs.options.RigidOptions(dt0.01), show_viewerTrue, ) # 非凸的坦克网格进入碰撞求解时会自动走凸分解路径 scene.add_entity( gs.morphs.Mesh( filemeshes/tank.obj, scale5.0, fixedTrue, euler(80, 10, 90), pos(0.05, -0.1, 0.0), ), vis_modecollision, # 显示分解后的碰撞网格方便肉眼检查 ) scene.build() for _ in range(2000): scene.step()三步拆开看初始化场景用gs.options.RigidOptions设定时间步长加入非凸实体并打开vis_modecollision——这是观察分解效果的开关能直接看到被拆成多少块凸包build()后循环step()让分解与缓存真正跑起来。想批量看分解效果可参考示例里的做法用gs.morphs.MJCF加载带output.xml的资产同样传vis_modecollision一次把多个非凸物体并排摆出来对比。⚙️ 避坑与调参高频问题与旋钮清单CoACD 的选项集中在 genesis/options/misc.py 的CoacdOptions最常用的几个class CoacdOptions(Options): threshold: float 0.1 # 主调精度旋钮减半约使凸包数翻倍 max_convex_hull: int -1 # -1 表示不限凸包数量 max_ch_vertex: int 256 # 单个凸包允许的最大顶点数 ...结合现象与原理这里给出几条可直接落地的建议碰撞体积明显偏大、包不住凹槽说明拆得太粗。把threshold往下调如 0.1 → 0.05凸包更贴形状代价是凸包变多、检测更慢。用vis_modecollision肉眼确认即可。拆得太碎、显存或帧率吃紧往回调threshold或设max_convex_hull给一个上限强制收敛凸包数量同时留意max_ch_vertex是否在限制单块凸包的细节。同一资产反复加载仍慢多半没吃到缓存。确认磁盘.cvx缓存目录可写、且参数未频繁改动参数一变键就变缓存失效同一资产的多个实例会自动共享内存级缓存。本就很凸的资产不必硬拆让它走误差阈值快速路径——近似凸的网格会用整体凸包近似跳过 CoACD若模型本身由作者手工拆成凸体可直接复用几乎零成本。动态物体分解后表现异常优先确认网格是否水密、法向是否一致。非凸碰撞网格在分解前会先做顶点焊接与面修复见 genesis/utils/mesh.py法向紊乱的网格会显著影响体积误差估计进而误判是否需要分解。一句话总结URDF 凸分解用 CoACD 把非凸碰撞网格切成少量凸体再用磁盘 .cvx 内存 512 MiB两级缓存和误差阈值快速路径摊薄成本从而在精度与性能之间取得可控平衡。官方文档README.md示例代码examples/rigid/分解与缓存源码genesis/utils/mesh.py、参数定义genesis/options/misc.py【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-world创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Genesis URDF 凸分解指南：非凸模型为何拖慢碰撞检测，以及如何调参提速
Genesis URDF 凸分解指南非凸模型为何拖慢碰撞检测以及如何调参提速【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-worldGenesis 是面向机器人与具身智能学习的通用仿真平台。它的 URDF 凸分解机制会把非凸的碰撞网格自动拆成一组凸包并叠加磁盘与内存两级缓存让复杂刚体的碰撞检测保持高效与稳定。本文拆解这套机制的原理、核心实现与调参方法。 现象导入模型越精细仿真越先卡先说一个很常见的场景。我们把一段建模精细的机械臂、一个带把手的水杯或一个不规则的抓取物体拖进场景里。刚加载完画面还很顺可一旦这些物体和地面、彼此发生接触帧率就开始往下掉接触点一多求解器还会报警物体甚至自己原地发抖。问题通常不出在模型好不好看而出在它的几何形状。视觉上圆润流畅的凹面、凹槽、镂空结构恰恰是碰撞检测里最难算的东西。这类非凸网格如果原样交给物理引擎往往要付出三重代价接触计算量随顶点数攀升越细越慢凹面之间的接触不连续约束方程更难收敛高细节顶点数据长期占用显存。Genesis 针对这件事给出的核心手段就是URDF 凸分解把一个难判断的凹体换成几个好判断的凸体。 原理推演非凸网格把检测拖慢的三处成本非凸刚体场景Genesis 会在碰撞求解前把非凸碰撞网格拆解为一组凸包并用碰撞网格显示模式呈现结果。为什么非凸会慢我们把碰撞检测拆成两层看窄相Narrow Phase。Genesis 刚体求解器里的 GJK / EPA 一类算法本质上是为凸体对凸体设计的它们假设两个物体各是一个整体凸包这样才能用少量迭代逼近最近点。一旦其中一方是凹体单个凸包就无法代表它的全部接触关系必须把它拆成多个凸体再对每一对凸体分别跑一次检测。凹体越绕拆出的凸体越多两两组合的接触对就越密。约束求解。每一对凸体接触都会生成一组约束位置、法向、摩擦。接触对一多约束规模上升迭代求解的每一步都更贵。内存。高细节非凸网格的顶点、法向、边邻接数据都要常驻显存同一资产若被多次实例化这些开销还会成倍累加。凸分解的价值就在这里它把接触判断的对象从一个高维凹面降为若干低维凸体检测与求解的复杂度随之从随顶点数飙升变成随凸包数量线性增长。代价是凸包数量本身——数量越少越快但形状近似误差越大这也是后面调参的核心矛盾。 关键实现拆解CoACD 分解与两级缓存Genesis 把凸分解放在碰撞网格的后处理阶段入口在 genesis/utils/mesh.py。它由三块组成我们逐个看。用 CoACD 把非凸体切成凸包真正执行分解的是 genesis/utils/mesh.py 里的convex_decompose它调用 CoACD 算法把输入网格切成一串凸体convex hull / boxdef convex_decompose(mesh, coacd_options): # 缩放无关用归一化顶点做缓存键同一资产的不同缩放共用一条记录 mesh_scale float(np.linalg.norm(mesh.extents)) cache get_cvx_cache(mesh.vertices / mesh_scale, mesh.faces, coacd_options) loaded cache.load() if loaded is not None: # 命中磁盘缓存直接读 .cvx并按比例缩放回当前尺寸 ... # 未命中才真正跑一次 CoACD再把结果落盘 result coacd.run_coacd( coacd.Mesh(mesh.vertices, mesh.faces), thresholdcoacd_options.threshold, max_convex_hullcoacd_options.max_convex_hull, max_ch_vertexcoacd_options.max_ch_vertex, ... ) mesh_parts [trimesh.Trimesh(vs, fs) for vs, fs in result] cache.save({mesh_parts: mesh_parts, mesh_scale: mesh_scale}) return mesh_parts注意threshold这个参数它是控制精度的主旋钮。经验上把阈值减半拆出的凸包数量大约翻倍——更贴合形状但更耗内存与检测时间。两级缓存磁盘 .cvx 与内存 SizeCappedCache分解是添加文件型实体里最贵的开销之一同一资产若在场景里出现多次没必要算很多遍。Genesis 用两级缓存来摊薄# 磁盘级同一网格 同一组 CoACD 参数 - 一个 .cvx 文件跨进程复用 def get_cvx_cache(verts, faces, coacd_options): return MeshCache(get_cvx_cache_dir(), cvx, verts, faces, coacd_options.__dict__) # 内存级按 512 MiB 上限缓存已处理碰撞网格同资产多实例共享同一份几何 _COLLISION_GEOMS_CACHE SizeCappedCache(max_bytes512 * 1024 * 1024)磁盘级缓存以网格 全部 CoACD 参数为键把结果存成.cvx文件重启后依然能命中内存级缓存则按实际占用的几何字节数顶点面封顶保证少量大资产和大量小资产都被限制住而不是简单按条目数砍。两者叠加把重复分解的成本压到接近零。误差阈值能偷懒就不分解并非每个非凸网格都值得完整分解。genesis/utils/mesh.py 会先试算一个整体凸包用体积偏差判断这个网格够不够凸# 先取整体凸包看它和原网格的体积差有多大 cmesh trimesh.convex.convex_hull(tmesh) volume_err abs(cmesh.volume / abs(tmesh.volume) - 1.0) if volume_err decompose_error_threshold: # 偏差过大必须走完整 CoACD 分解 ...偏差小于阈值时直接用一个凸包就能近似省去整轮 CoACD只有凹得明显的网格才触发分解。这是一条很实用的快速路径——它让作者已手动拆成凸体的资产几乎零成本地跳过分解。 上手验证三步跑通加载—分解—仿真完整可运行的示例见 examples/rigid/其中convex_decomposition.py就演示了带vis_modecollision的碰撞网格显示。最小流程是import genesis as gs gs.init(backendgs.gpu, precision32, seed0) scene gs.Scene( rigid_optionsgs.options.RigidOptions(dt0.01), show_viewerTrue, ) # 非凸的坦克网格进入碰撞求解时会自动走凸分解路径 scene.add_entity( gs.morphs.Mesh( filemeshes/tank.obj, scale5.0, fixedTrue, euler(80, 10, 90), pos(0.05, -0.1, 0.0), ), vis_modecollision, # 显示分解后的碰撞网格方便肉眼检查 ) scene.build() for _ in range(2000): scene.step()三步拆开看初始化场景用gs.options.RigidOptions设定时间步长加入非凸实体并打开vis_modecollision——这是观察分解效果的开关能直接看到被拆成多少块凸包build()后循环step()让分解与缓存真正跑起来。想批量看分解效果可参考示例里的做法用gs.morphs.MJCF加载带output.xml的资产同样传vis_modecollision一次把多个非凸物体并排摆出来对比。⚙️ 避坑与调参高频问题与旋钮清单CoACD 的选项集中在 genesis/options/misc.py 的CoacdOptions最常用的几个class CoacdOptions(Options): threshold: float 0.1 # 主调精度旋钮减半约使凸包数翻倍 max_convex_hull: int -1 # -1 表示不限凸包数量 max_ch_vertex: int 256 # 单个凸包允许的最大顶点数 ...结合现象与原理这里给出几条可直接落地的建议碰撞体积明显偏大、包不住凹槽说明拆得太粗。把threshold往下调如 0.1 → 0.05凸包更贴形状代价是凸包变多、检测更慢。用vis_modecollision肉眼确认即可。拆得太碎、显存或帧率吃紧往回调threshold或设max_convex_hull给一个上限强制收敛凸包数量同时留意max_ch_vertex是否在限制单块凸包的细节。同一资产反复加载仍慢多半没吃到缓存。确认磁盘.cvx缓存目录可写、且参数未频繁改动参数一变键就变缓存失效同一资产的多个实例会自动共享内存级缓存。本就很凸的资产不必硬拆让它走误差阈值快速路径——近似凸的网格会用整体凸包近似跳过 CoACD若模型本身由作者手工拆成凸体可直接复用几乎零成本。动态物体分解后表现异常优先确认网格是否水密、法向是否一致。非凸碰撞网格在分解前会先做顶点焊接与面修复见 genesis/utils/mesh.py法向紊乱的网格会显著影响体积误差估计进而误判是否需要分解。一句话总结URDF 凸分解用 CoACD 把非凸碰撞网格切成少量凸体再用磁盘 .cvx 内存 512 MiB两级缓存和误差阈值快速路径摊薄成本从而在精度与性能之间取得可控平衡。官方文档README.md示例代码examples/rigid/分解与缓存源码genesis/utils/mesh.py、参数定义genesis/options/misc.py【免费下载链接】genesis-worldSimulation platform for general-purpose robotics embodied AI learning.项目地址: https://gitcode.com/GitHub_Trending/genesi/genesis-world创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考