` 与 `eval_mimic()` 实战指南)
Newton 关节模仿元数据Joint Mimic Metadata深度解析set_joint_mimic()与eval_mimic()实战指南【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton本文以 Newton 开源物理引擎新增的 joint-owned mimic关节自持模仿元数据为核心系统讲解如何通过ModelBuilder.set_joint_mimic()为维度匹配的非四元数关节建立从动/参考关节之间的仿射跟随关系如何通过eval_mimic()分量式刷新从动关节广义坐标以及该机制在 Featherstone、SemiImplicit、XPBD、MuJoCo 与 VBD 五大求解器中的支持方式与行为差异。读完本文你将掌握利用关节模仿关系建模丝杠、平行夹爪、同步连杆等机械结构的完整实战方案并理解其底层实现与调参要点。什么是 joint-owned mimic 元数据在 Newton 中mimic模仿指一个关节的广义坐标按照固定仿射关系跟随另一个关节运动。传统实现以“约束constraint”形式存在即ModelBuilder.add_constraint_mimic()而本次变更将其升级为关节自持的元数据joint-owned mimic metadata直接挂载在关节上支持 PRISMATIC、REVOLUTE、D6 三种维度匹配的非四元数关节类型。从源码结构看模型最终将 mimic 关系编译为两个张量数组Model.joint_mimic_jointwp.int32数组每个关节对应的参考关节索引-1表示独立关节见 builder.py 第 13594 行附近的模型编译逻辑Model.joint_mimic_coeffswp.vec2数组每个关节的offset, multiplier系数对。需要特别指出的是旧 APIadd_constraint_mimic()已标记为弃用DeprecationWarning文档明确要求“Useset_joint_mimic()for joints with matching dimensions instead”见 builder.py。新 API 以关节为单位存储元数据取代了独立的约束记录语义更清晰、GPU 内核访问更直接。核心 APIModelBuilder.set_joint_mimic()set_joint_mimic()是构建期配置关节模仿关系的唯一入口签名如下见 builder.pybuilder.set_joint_mimic( joint: int, # 从动关节follower索引 reference_joint: int | None, # 参考关节索引传 None 表示解除关系 coeffs: Vec2 (0.0, 1.0), # (offset, multiplier)默认恒等跟随 ) - None数学关系模仿关系按**分量逐项componentwise**作用于每个位置与速度坐标q[joint] coeffs[0] coeffs[1] * q[reference_joint] qd[joint] coeffs[1] * qd[reference_joint]即从动关节的每个广义坐标分量都等于“偏移量 倍率 × 参考关节对应分量”速度分量为“倍率 × 参考速度分量”。其中coeffs[0]的量纲为 m平移或 rad旋转coeffs[1]无量纲。当reference_joint传None时该关节被重置为独立关节joint_mimic_joint[joint] -1系数复位为(0.0, 1.0)。严格的构建期校验set_joint_mimic()并非无脑写入而是在构建期执行一系列校验任何一条不满足都会抛出ValueError见 builder.py校验项说明索引合法性follower 与 reference 索引必须位于0..joint_count-1区间内且不允许关节模仿自身维度匹配两关节的位置维度与速度维度必须完全一致报错信息会给出(q?, qd?)明细世界一致两关节必须属于同一个 world构型一致若两者都归属 articulation则必须属于同一个articulation系数有限性offset与multiplier都必须为有限浮点数math.isfinite禁止 mimic 链参考关节本身不得是某个 mimic 的从动关节且从动关节不得已被其他 mimic 引用——即不支持链式/多级模仿最后一条“禁止链条”保证了模仿关系是单层、无环的从而 GPU 内核可以用简单的“一次遍历 一次解引用”完成更新无需迭代收敛。eval_mimic()分量式从动坐标刷新eval_mimic()是运行时手动刷新从动关节坐标的入口见 joint_mimic.pynewton.eval_mimic(model, state_in, state_outNone) - None对每个从动关节读取参考关节的全部位置与速度坐标按Model.joint_mimic_coeffs写入从动关节对应坐标独立关节保持不变。只写入State.joint_q与State.joint_qd两个数组不涉及体姿态。state_out省略时原地更新state_in否则先将state_in的全部关节坐标拷贝到state_out再在state_out上更新从动关节。若任一 state 缺少joint_q/joint_qd数组抛出ValueError。其底层是 Warp kerneleval_mimic_jointsjoint_mimic.py以wp.tid()绑定关节索引从joint_mimic_joint[joint]取得参考关节随后按joint_q_start/joint_qd_start的区间切分对每个坐标依次执行joint_q coeffs[0] coeffs[1] * joint_q[ref]与joint_qd coeffs[1] * joint_qd[ref]。整个 kernel 以model.joint_count为线程维度一次发射完成。该函数在初始状态不一致时尤其关键测试注释指出见 test_solver_mimic.pyVBD 求解器只在其收敛域内做逐迭代投影因此大幅度的初始不一致应先在仿真前通过eval_mimic()eval_fk()校正到一致状态再开始积分。求解器支持矩阵与实现机制本次变更将 mimic 支持带入了五大求解器Featherstone、SemiImplicit、XPBD、MuJoCo、VBD。仓库测试test_solver_mimic.py通过统一的_test_solver_mimic()驱动同一组标量/向量化模型在所有求解器上验证“每个从动坐标满足仿射关系”容差atol2.0e-3见 test_solver_mimic.py。各求解器的实现方式并不相同理解这一点有助于选择求解器Featherstone / XPBD / MuJoCo以约束或投影方式在求解迭代内直接满足 mimic 关系分别见 solver_featherstone.py、solver_xpbd.py、solver_mujoco.py 中读取joint_mimic_joint的相关逻辑VBD在每个求解器迭代内做一次局部 mimic 投影对应测试中small_mismatchTrue的收敛域处理SemiImplicit特殊之处见下一节。此外has_supported_joint_mimics(model, solver_name)joint_mimic.py会在求解器构造时扫描 mimic 关节若存在两关节不同时为 PRISMATIC/REVOLUTE/D6的组合则发出 warning 说明该求解器会忽略这些不支持的模仿关系最多报告前 10 个索引。SemiImplicit 的罚弹簧实现joint_mimic_ke/joint_mimic_kdSemiImplicit 是唯一以**罚弹簧penalty spring**方式实施 mimic 的求解器因此引入了两个全局增益参数见 solver_semi_implicit.pysolver newton.solvers.SolverSemiImplicit( model, joint_mimic_ke1.0e2, # 默认值 joint_mimic_kd1.0, # 默认值 )参数默认值单位含义joint_mimic_ke1.0e2线性坐标N/m角向坐标N·m/rad位置误差增益弹簧刚度joint_mimic_kd1.0线性坐标N·s/m角向坐标N·m·s/rad速度误差增益阻尼构造时二者必须为有限且非负的数值否则抛出ValueError测试test_semi_implicit_mimic_validates_gains用-1.0、nan、inf三个值逐一验证见 test_solver_mimic.py。底层罚力计算位于 kernels_body.pyposition_error follower_q - offset - multiplier * reference_q # 角向分量先做 atan2(sin, cos) 环绕归一化避免跨 ±π 时误差跳变 velocity_error follower_qd - multiplier * reference_qd force -joint_mimic_ke * position_error - joint_mimic_kd * velocity_error随后该力以“作用力/反作用力”方式施加到四个相关体上从动关节父/子体施加gradient * force参考关节父/子体施加-multiplier * forcewp.atomic_add累加。注意两个细节角向误差环绕处理当 follower 与 reference 都是旋转分量时位置误差先经atan2(sin, cos)归一化到(-π, π]防止跨过 2π 边界时误差突变导致弹簧爆发运动学参考保持测试test_semi_implicit_mimic_preserves_kinematic_reference验证了当参考关节体被标记为BodyFlags.KINEMATIC时其位姿与速度在 480 步积分后保持atol1.0e-7不变而 on 从动关节仍严格满足模仿关系见 test_solver_mimic.py。由于是罚弹簧SemiImplicit 的稳定性与精度取决于joint_mimic_ke、joint_mimic_kd以及仿真步长刚度过高而步长不足会引发振荡刚度过低则跟随误差偏大。文档与示例均建议按机构质量与目标步长如 240 Hz联合调参。实战基于 mimic 建模丝杠lead screw仓库提供了完整的可运行示例 example_basic_mimic_joint.py它用一个旋转关节丝杠 一个移动关节螺母演示关节模仿关系将旋转转化为直线行程q_nut pitch / (2 * pi) * q_screw构建核心代码builder newton.ModelBuilder(gravity(0.0, 0.0, 0.0)) screw_joint builder.add_joint_revolute( parent-1, childscrew_body, axisnewton.Axis.Z, parent_xformwp.transform(p(0.0, 0.0, 1.5), qwp.quat_identity()), target_ke80.0, target_kd10.0, effort_limit200.0, labelscrew_rotation, ) nut_joint builder.add_joint_prismatic( parent-1, childnut_body, axisnewton.Axis.Z, parent_xformwp.transform(p(0.0, 0.0, 1.5), qwp.quat_identity()), limit_lower-0.6, limit_upper0.6, limit_ke1.0e4, limit_kd100.0, damping0.2, labelnut_translation, ) builder.add_articulation([screw_joint, nut_joint], labellead_screw) builder.set_joint_mimic(nut_joint, screw_joint, coeffs(0.0, coupling_ratio))其中coupling_ratio pitch / (2.0 * math.pi)即丝杠每转一周、螺母前进一个螺距的几何关系。这正是set_joint_mimic()的典型用法offset0.0、multiplier耦合比让 D1 维的 PRISMATIC 关节跟随 D1 维的 REVOLUTE 关节维度完全匹配。运行方式与命令行参数python -m newton.examples basic_mimic_joint --solver xpbd --pitch 1.2示例为所有求解器统一暴露两个参数见 example_basic_mimic_joint.py--solver可选featherstone、semi_implicit、xpbd、mujoco、vbd默认xpbd--pitch丝杠每转行程m/rev默认1.2必须为有限非零值且保证丝杠摆动幅度小于半圈否则抛错。各求解器的推荐配置示例_create_solver()给出了针对该机构的实测参数# Featherstone直接硬约束 newton.solvers.SolverFeatherstone(model) # SemiImplicit罚弹簧需针对机构质量与 240Hz 步长调高增益 newton.solvers.SolverSemiImplicit(model, joint_mimic_ke5.0e4, joint_mimic_kd5.0e2) # XPBD10 次迭代 newton.solvers.SolverXPBD(model, iterations10) # MuJoCo510 次迭代禁用碰撞以聚焦关节行为 newton.solvers.SolverMuJoCo(model, iterations5, ls_iterations10, disable_contactsTrue, use_mujoco_cpuwp.get_device().is_cpu) # VBD2 次迭代 高刚度关节线性/角向刚度无需子步 newton.solvers.SolverVBD(model, iterations2, rigid_compliant_almTrue, rigid_joint_linear_ke1.0e6, rigid_joint_angular_ke1.0e6)值得注意的实现细节SemiImplicit 需要DEFAULT_SIM_SUBSTEPS 4个子步240 Hz来稳定罚弹簧而 VBD 因为每次迭代内部都投影 mimic 关系示例将其子步数设为 1example_basic_mimic_joint.py。示例的test_final()自检包含两项硬指标丝杠累计转角必须超过 0.5 rad且螺母耦合误差不得超过 10 mm否则抛出ValueError——可作为自定义 mimic 用例验收标准的参考。运行时 GUI 会实时显示螺距、丝杠转数rev、螺母行程m与“Mimic error [mm]”诊断曲线方便观察罚弹簧行为。测试覆盖与行为验证专用测试文件 test_solver_mimic.py 以add_function_test方式注册并在所有测试设备上运行测试验证点test_featherstone_mimic标量/向量化 mimic 关系在 Featherstone 中成立从动关节施加的力能传递到参考关节坐标_test_featherstone_force_transfer参考关节速度显著非零test_semi_implicit_mimic罚弹簧在 240 步积分后误差收敛到atol2.0e-3内test_semi_implicit_mimic_preserves_kinematic_reference运动学参考关节位姿/速度保持1.0e-7不变test_semi_implicit_mimic_validates_gainsjoint_mimic_ke/joint_mimic_kd拒绝负值与非有限值test_vbd_mimicVBD 迭代内投影在小初始不一致下满足关系测试构造的模型覆盖了两种形态标量形态REVOLUTE 参考 PRISMATIC 从动与向量化形态两个 2-DOF 线性 D6 关节后者验证了 mimic 元数据对多自由度关节逐分量跟随的支持这也是它区别于旧约束式 mimic旧实现将 mimic 均等地应用于所有自由度的关键改进。此外test_model.py、test_builder_replicate.py 等测试确认了joint_mimic_joint/joint_mimic_coeffs在模型复制、关节重映射等流程中的正确传播见 builder.py 的joint_remap.get(mimic_joint, -1)处理。适用边界与注意事项关节类型限制仅 PRISMATIC、REVOLUTE、D6 三类支持关节模仿见_SUPPORTED_JOINT_TYPESjoint_mimic.py。BALL 等四元数关节与 ROD 关节不在支持范围内混用时会触发has_supported_joint_mimics的 warning禁止链式模仿参考关节必须独立任何关节只能作为一次 mimic 的从动方维度必须严格一致位置/速度维度任一不匹配都会在构建期报错无法用不同 DOF 数的关节做 mimic初始一致性若初始状态下从动坐标与参考坐标严重不一致务必先用eval_mimic()eval_fk()校正VBD 尤其依赖其局部收敛域SemiImplicit 调参罚弹簧的跟随精度由joint_mimic_ke/joint_mimic_kd与步长共同决定示例在 240 Hz 下使用5.0e4/5.0e2远高于默认值1.0e2/1.0说明默认参数适用于轻量场景重载机构需按质量调大刚度弃用迁移add_constraint_mimic()已在 Newton 1.6 弃用新代码应统一迁移到set_joint_mimic()维度匹配场景旧的稀疏 mimic 约束在 SemiImplicit 中已不支持。综上joint-owned mimic 元数据将关节模仿从“额外的约束对象”重构为“关节自身的属性”配合eval_mimic()的分量式坐标刷新与五大求解器的原生支持为丝杠、同步手指等耦合机构提供了统一、高效、可校验的建模路径。【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Newton 关节模仿元数据（Joint Mimic Metadata）深度解析：`set_joint_mimic()` 与 `eval_mimic()` 实战指南
Newton 关节模仿元数据Joint Mimic Metadata深度解析set_joint_mimic()与eval_mimic()实战指南【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton本文以 Newton 开源物理引擎新增的 joint-owned mimic关节自持模仿元数据为核心系统讲解如何通过ModelBuilder.set_joint_mimic()为维度匹配的非四元数关节建立从动/参考关节之间的仿射跟随关系如何通过eval_mimic()分量式刷新从动关节广义坐标以及该机制在 Featherstone、SemiImplicit、XPBD、MuJoCo 与 VBD 五大求解器中的支持方式与行为差异。读完本文你将掌握利用关节模仿关系建模丝杠、平行夹爪、同步连杆等机械结构的完整实战方案并理解其底层实现与调参要点。什么是 joint-owned mimic 元数据在 Newton 中mimic模仿指一个关节的广义坐标按照固定仿射关系跟随另一个关节运动。传统实现以“约束constraint”形式存在即ModelBuilder.add_constraint_mimic()而本次变更将其升级为关节自持的元数据joint-owned mimic metadata直接挂载在关节上支持 PRISMATIC、REVOLUTE、D6 三种维度匹配的非四元数关节类型。从源码结构看模型最终将 mimic 关系编译为两个张量数组Model.joint_mimic_jointwp.int32数组每个关节对应的参考关节索引-1表示独立关节见 builder.py 第 13594 行附近的模型编译逻辑Model.joint_mimic_coeffswp.vec2数组每个关节的offset, multiplier系数对。需要特别指出的是旧 APIadd_constraint_mimic()已标记为弃用DeprecationWarning文档明确要求“Useset_joint_mimic()for joints with matching dimensions instead”见 builder.py。新 API 以关节为单位存储元数据取代了独立的约束记录语义更清晰、GPU 内核访问更直接。核心 APIModelBuilder.set_joint_mimic()set_joint_mimic()是构建期配置关节模仿关系的唯一入口签名如下见 builder.pybuilder.set_joint_mimic( joint: int, # 从动关节follower索引 reference_joint: int | None, # 参考关节索引传 None 表示解除关系 coeffs: Vec2 (0.0, 1.0), # (offset, multiplier)默认恒等跟随 ) - None数学关系模仿关系按**分量逐项componentwise**作用于每个位置与速度坐标q[joint] coeffs[0] coeffs[1] * q[reference_joint] qd[joint] coeffs[1] * qd[reference_joint]即从动关节的每个广义坐标分量都等于“偏移量 倍率 × 参考关节对应分量”速度分量为“倍率 × 参考速度分量”。其中coeffs[0]的量纲为 m平移或 rad旋转coeffs[1]无量纲。当reference_joint传None时该关节被重置为独立关节joint_mimic_joint[joint] -1系数复位为(0.0, 1.0)。严格的构建期校验set_joint_mimic()并非无脑写入而是在构建期执行一系列校验任何一条不满足都会抛出ValueError见 builder.py校验项说明索引合法性follower 与 reference 索引必须位于0..joint_count-1区间内且不允许关节模仿自身维度匹配两关节的位置维度与速度维度必须完全一致报错信息会给出(q?, qd?)明细世界一致两关节必须属于同一个 world构型一致若两者都归属 articulation则必须属于同一个articulation系数有限性offset与multiplier都必须为有限浮点数math.isfinite禁止 mimic 链参考关节本身不得是某个 mimic 的从动关节且从动关节不得已被其他 mimic 引用——即不支持链式/多级模仿最后一条“禁止链条”保证了模仿关系是单层、无环的从而 GPU 内核可以用简单的“一次遍历 一次解引用”完成更新无需迭代收敛。eval_mimic()分量式从动坐标刷新eval_mimic()是运行时手动刷新从动关节坐标的入口见 joint_mimic.pynewton.eval_mimic(model, state_in, state_outNone) - None对每个从动关节读取参考关节的全部位置与速度坐标按Model.joint_mimic_coeffs写入从动关节对应坐标独立关节保持不变。只写入State.joint_q与State.joint_qd两个数组不涉及体姿态。state_out省略时原地更新state_in否则先将state_in的全部关节坐标拷贝到state_out再在state_out上更新从动关节。若任一 state 缺少joint_q/joint_qd数组抛出ValueError。其底层是 Warp kerneleval_mimic_jointsjoint_mimic.py以wp.tid()绑定关节索引从joint_mimic_joint[joint]取得参考关节随后按joint_q_start/joint_qd_start的区间切分对每个坐标依次执行joint_q coeffs[0] coeffs[1] * joint_q[ref]与joint_qd coeffs[1] * joint_qd[ref]。整个 kernel 以model.joint_count为线程维度一次发射完成。该函数在初始状态不一致时尤其关键测试注释指出见 test_solver_mimic.pyVBD 求解器只在其收敛域内做逐迭代投影因此大幅度的初始不一致应先在仿真前通过eval_mimic()eval_fk()校正到一致状态再开始积分。求解器支持矩阵与实现机制本次变更将 mimic 支持带入了五大求解器Featherstone、SemiImplicit、XPBD、MuJoCo、VBD。仓库测试test_solver_mimic.py通过统一的_test_solver_mimic()驱动同一组标量/向量化模型在所有求解器上验证“每个从动坐标满足仿射关系”容差atol2.0e-3见 test_solver_mimic.py。各求解器的实现方式并不相同理解这一点有助于选择求解器Featherstone / XPBD / MuJoCo以约束或投影方式在求解迭代内直接满足 mimic 关系分别见 solver_featherstone.py、solver_xpbd.py、solver_mujoco.py 中读取joint_mimic_joint的相关逻辑VBD在每个求解器迭代内做一次局部 mimic 投影对应测试中small_mismatchTrue的收敛域处理SemiImplicit特殊之处见下一节。此外has_supported_joint_mimics(model, solver_name)joint_mimic.py会在求解器构造时扫描 mimic 关节若存在两关节不同时为 PRISMATIC/REVOLUTE/D6的组合则发出 warning 说明该求解器会忽略这些不支持的模仿关系最多报告前 10 个索引。SemiImplicit 的罚弹簧实现joint_mimic_ke/joint_mimic_kdSemiImplicit 是唯一以**罚弹簧penalty spring**方式实施 mimic 的求解器因此引入了两个全局增益参数见 solver_semi_implicit.pysolver newton.solvers.SolverSemiImplicit( model, joint_mimic_ke1.0e2, # 默认值 joint_mimic_kd1.0, # 默认值 )参数默认值单位含义joint_mimic_ke1.0e2线性坐标N/m角向坐标N·m/rad位置误差增益弹簧刚度joint_mimic_kd1.0线性坐标N·s/m角向坐标N·m·s/rad速度误差增益阻尼构造时二者必须为有限且非负的数值否则抛出ValueError测试test_semi_implicit_mimic_validates_gains用-1.0、nan、inf三个值逐一验证见 test_solver_mimic.py。底层罚力计算位于 kernels_body.pyposition_error follower_q - offset - multiplier * reference_q # 角向分量先做 atan2(sin, cos) 环绕归一化避免跨 ±π 时误差跳变 velocity_error follower_qd - multiplier * reference_qd force -joint_mimic_ke * position_error - joint_mimic_kd * velocity_error随后该力以“作用力/反作用力”方式施加到四个相关体上从动关节父/子体施加gradient * force参考关节父/子体施加-multiplier * forcewp.atomic_add累加。注意两个细节角向误差环绕处理当 follower 与 reference 都是旋转分量时位置误差先经atan2(sin, cos)归一化到(-π, π]防止跨过 2π 边界时误差突变导致弹簧爆发运动学参考保持测试test_semi_implicit_mimic_preserves_kinematic_reference验证了当参考关节体被标记为BodyFlags.KINEMATIC时其位姿与速度在 480 步积分后保持atol1.0e-7不变而 on 从动关节仍严格满足模仿关系见 test_solver_mimic.py。由于是罚弹簧SemiImplicit 的稳定性与精度取决于joint_mimic_ke、joint_mimic_kd以及仿真步长刚度过高而步长不足会引发振荡刚度过低则跟随误差偏大。文档与示例均建议按机构质量与目标步长如 240 Hz联合调参。实战基于 mimic 建模丝杠lead screw仓库提供了完整的可运行示例 example_basic_mimic_joint.py它用一个旋转关节丝杠 一个移动关节螺母演示关节模仿关系将旋转转化为直线行程q_nut pitch / (2 * pi) * q_screw构建核心代码builder newton.ModelBuilder(gravity(0.0, 0.0, 0.0)) screw_joint builder.add_joint_revolute( parent-1, childscrew_body, axisnewton.Axis.Z, parent_xformwp.transform(p(0.0, 0.0, 1.5), qwp.quat_identity()), target_ke80.0, target_kd10.0, effort_limit200.0, labelscrew_rotation, ) nut_joint builder.add_joint_prismatic( parent-1, childnut_body, axisnewton.Axis.Z, parent_xformwp.transform(p(0.0, 0.0, 1.5), qwp.quat_identity()), limit_lower-0.6, limit_upper0.6, limit_ke1.0e4, limit_kd100.0, damping0.2, labelnut_translation, ) builder.add_articulation([screw_joint, nut_joint], labellead_screw) builder.set_joint_mimic(nut_joint, screw_joint, coeffs(0.0, coupling_ratio))其中coupling_ratio pitch / (2.0 * math.pi)即丝杠每转一周、螺母前进一个螺距的几何关系。这正是set_joint_mimic()的典型用法offset0.0、multiplier耦合比让 D1 维的 PRISMATIC 关节跟随 D1 维的 REVOLUTE 关节维度完全匹配。运行方式与命令行参数python -m newton.examples basic_mimic_joint --solver xpbd --pitch 1.2示例为所有求解器统一暴露两个参数见 example_basic_mimic_joint.py--solver可选featherstone、semi_implicit、xpbd、mujoco、vbd默认xpbd--pitch丝杠每转行程m/rev默认1.2必须为有限非零值且保证丝杠摆动幅度小于半圈否则抛错。各求解器的推荐配置示例_create_solver()给出了针对该机构的实测参数# Featherstone直接硬约束 newton.solvers.SolverFeatherstone(model) # SemiImplicit罚弹簧需针对机构质量与 240Hz 步长调高增益 newton.solvers.SolverSemiImplicit(model, joint_mimic_ke5.0e4, joint_mimic_kd5.0e2) # XPBD10 次迭代 newton.solvers.SolverXPBD(model, iterations10) # MuJoCo510 次迭代禁用碰撞以聚焦关节行为 newton.solvers.SolverMuJoCo(model, iterations5, ls_iterations10, disable_contactsTrue, use_mujoco_cpuwp.get_device().is_cpu) # VBD2 次迭代 高刚度关节线性/角向刚度无需子步 newton.solvers.SolverVBD(model, iterations2, rigid_compliant_almTrue, rigid_joint_linear_ke1.0e6, rigid_joint_angular_ke1.0e6)值得注意的实现细节SemiImplicit 需要DEFAULT_SIM_SUBSTEPS 4个子步240 Hz来稳定罚弹簧而 VBD 因为每次迭代内部都投影 mimic 关系示例将其子步数设为 1example_basic_mimic_joint.py。示例的test_final()自检包含两项硬指标丝杠累计转角必须超过 0.5 rad且螺母耦合误差不得超过 10 mm否则抛出ValueError——可作为自定义 mimic 用例验收标准的参考。运行时 GUI 会实时显示螺距、丝杠转数rev、螺母行程m与“Mimic error [mm]”诊断曲线方便观察罚弹簧行为。测试覆盖与行为验证专用测试文件 test_solver_mimic.py 以add_function_test方式注册并在所有测试设备上运行测试验证点test_featherstone_mimic标量/向量化 mimic 关系在 Featherstone 中成立从动关节施加的力能传递到参考关节坐标_test_featherstone_force_transfer参考关节速度显著非零test_semi_implicit_mimic罚弹簧在 240 步积分后误差收敛到atol2.0e-3内test_semi_implicit_mimic_preserves_kinematic_reference运动学参考关节位姿/速度保持1.0e-7不变test_semi_implicit_mimic_validates_gainsjoint_mimic_ke/joint_mimic_kd拒绝负值与非有限值test_vbd_mimicVBD 迭代内投影在小初始不一致下满足关系测试构造的模型覆盖了两种形态标量形态REVOLUTE 参考 PRISMATIC 从动与向量化形态两个 2-DOF 线性 D6 关节后者验证了 mimic 元数据对多自由度关节逐分量跟随的支持这也是它区别于旧约束式 mimic旧实现将 mimic 均等地应用于所有自由度的关键改进。此外test_model.py、test_builder_replicate.py 等测试确认了joint_mimic_joint/joint_mimic_coeffs在模型复制、关节重映射等流程中的正确传播见 builder.py 的joint_remap.get(mimic_joint, -1)处理。适用边界与注意事项关节类型限制仅 PRISMATIC、REVOLUTE、D6 三类支持关节模仿见_SUPPORTED_JOINT_TYPESjoint_mimic.py。BALL 等四元数关节与 ROD 关节不在支持范围内混用时会触发has_supported_joint_mimics的 warning禁止链式模仿参考关节必须独立任何关节只能作为一次 mimic 的从动方维度必须严格一致位置/速度维度任一不匹配都会在构建期报错无法用不同 DOF 数的关节做 mimic初始一致性若初始状态下从动坐标与参考坐标严重不一致务必先用eval_mimic()eval_fk()校正VBD 尤其依赖其局部收敛域SemiImplicit 调参罚弹簧的跟随精度由joint_mimic_ke/joint_mimic_kd与步长共同决定示例在 240 Hz 下使用5.0e4/5.0e2远高于默认值1.0e2/1.0说明默认参数适用于轻量场景重载机构需按质量调大刚度弃用迁移add_constraint_mimic()已在 Newton 1.6 弃用新代码应统一迁移到set_joint_mimic()维度匹配场景旧的稀疏 mimic 约束在 SemiImplicit 中已不支持。综上joint-owned mimic 元数据将关节模仿从“额外的约束对象”重构为“关节自身的属性”配合eval_mimic()的分量式坐标刷新与五大求解器的原生支持为丝杠、同步手指等耦合机构提供了统一、高效、可校验的建模路径。【免费下载链接】newtonAn open-source, GPU-accelerated physics simulation engine built upon NVIDIA Warp, specifically targeting roboticists and simulation researchers.项目地址: https://gitcode.com/GitHub_Trending/newton9/newton创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
