# MJX肌腱缠绕float32精度偏差及wrap_inside梯度NaN修复

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-07-mujoco-3679
> 频道：pitfalls | 更新日期：2026-11-07 | 标签：auto, github-issue, mujoco
> 核心摘要：MJX肌腱缠绕在float32下存在路径错误及梯度NaN，需移植C端数值稳定逻辑并增加asin输入裁剪。

# MJX肌腱缠绕float32精度偏差及wrap_inside梯度NaN修复

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[[MJX] Tendon wrapping: grazing wraps take the far side in float32, and inside wraps fall back to the midpoint](https://github.com/google-deepmind/mujoco/issues/3679)（GitHub google-deepmind/mujoco #3679）

**状态**：有绕过办法

## 问题

MJX-JAX中sphere/cylinder肌腱缠绕存在两类问题：1. float32下Grazing wraps因`_is_intersect`数值误差导致绕行远侧，误差达114.6mm；2. `wrap_inside`迭代参数（maxiter=5, tol=1e-4）与C端不一致致位置偏差，且`z_init=1-1e-5`使Newton迭代越界，触发`jp.sqrt`负数输入与`arcsin`域外计算，导致`jax.

## 环境

MuJoCo 3.15.0, MJX 3.15.0, JAX 0.11.2, macOS Apple Silicon CPU

## 解决办法

1. 修改`_is_intersect`，使用`p2 - p4`作为上界替代商`a`和`b`以消除float32舍入误差。
2. 修改`_length_circle`，改用`arctan2`计算角度以提升数值稳定性。
3. 重构`wrap_inside`：移除`z_init`，改为对`phi = asin(z)`从`pi/2`开始Newton迭代；将`maxiter`设为20，`tolerance`设为1e-6；未收敛时返回中点而非最后迭代值。
4. 在Newton迭代更新`z_next`后，立即执行`z_next = jp.clip(z_next, -1.0 + 1e-7, 1.0 - 1e-7)`，防止`sqrt`负数输入及`arcsin`导数无穷大导致的梯度NaN（仅clip至±1或使用mjMINVAL无效）。

讨论原作者：@son-engr-kr 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub google-deepmind/mujoco #3679：[MJX] Tendon wrapping: grazing wraps take the far side in float32, and inside wraps fall back to the midpoint](https://github.com/google-deepmind/mujoco/issues/3679)