unitree-g1-mujoco / VALIDATION.md
k-valentin's picture
Import lerobot/unitree-g1-mujoco@68459ed6 + 23dof (rev_1_0) body variant, defaults BODY=23dof END_EFFECTOR=dummy
257dded verified
|
Raw History Blame Contribute Delete
1.91 kB

Validation of this update

Validated with MuJoCo 3.3.7, Python 3.12 and EGL offscreen rendering.

  • Five regression tests passed using real MuJoCo: both variants and their body control mappings, gripper closure under external PD with a 20 N force cap, independent wrist-camera motion, rendering and shared-memory publication of all three 640 × 480 streams, and loading the portable 33-joint gripper URDF.
  • Gripper scene: nq=40, nv=39, nu=33. Hand scene: nq=50, nv=49, nu=43. Both retain the 29 body joints in the original DDS order. Both also retain global_view in addition to the three streamed cameras.
  • The closure test ran 250 physics steps (1 simulated second), reached closure on both grippers, stayed within the 20 N actuator limit and reported no MuJoCo numerical warnings.
  • Original hand/no-hand model assets are retained. The hand camera variant adds cameras to a copy of the original model.

The regression tests replace only the DDS dependency with a test double. A complete live LeRobot/Gym/DDS/ZMQ connection was not run here because Gymnasium, Unitree SDK2/CycloneDDS, ZMQ and OpenCV were unavailable in the execution environment. tests/smoke_live.py is included to run that check on a machine with the runtime dependencies installed. The ZMQ publisher and message serializer are unchanged; the configured camera list now includes the wrists.

The Gym wrapper's acceleration contribution is restricted to three values, matching its declared 97-value observation space. This fixes the original wrapper's mismatch of 100 returned values versus 97 declared values.

Prepared against Hugging Face model revision a38dc8617f0fca51b38e9354dc58ee35ad850fb5, with the LeRobot loader and camera configuration reviewed at b6ec0060779550c0a157ae34feb89e0cf86012a8. The archive is a complete local model-repository update; it has not been published to Hugging Face.