Repository navigation
Feature/h2 integration - #2
Merged
Merged
Conversation
…matics for Unitree H2
5 of 7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR introduces full support and locomotion integration for the Unitree H2 humanoid robot (31 active DOFs) across both the Direct RL (
HeteroHumanoidEnv) and Manager-Based frameworks.It extends the heterogeneous humanoid mapping to support robots with a 3-axis active waist (
waist_yaw,waist_roll,waist_pitch), resolves kinematic sign conventions for humanoid ankle roll, and introduces a smooth gait-symmetry regulation mechanism to ensure clean, limp-free bipedal walking.Key Features & Technical Details
robot_configs.pycovering:waist_yaw,waist_roll,waist_pitch)hetero_humanoid_env.pywhere a generic substring match on"ankle"inadvertently flippedankle_rollto-1.0whilehip_rollwas+1.0. Withand "roll" not in jname, both hip and ankle roll consistently share positive coordinate conventions (feet_air_time_symmetry_bipedto the heterogeneous reward pipeline with smooth yaw-command gating. This penalizes asymmetric air-time between the left and right foot during straight walking, eliminating the asymmetric "short-step / long-step" limp without hindering differential stepping during turns.dof_pos_limitsto actively cover knee hyperextension and waist pitch limits, combined with reinforced waist pitch (Isaac-Velocity-Flat-HeteroHumanoid-v0enabling both single-robot training (--humanoids h2) and heterogeneous co-training alongside Cassie, Digit, G1, and H1.Isaac-Velocity-Flat-H2-v0andIsaac-Velocity-Rough-H2-v0) with natural-frequency-matched actuator constants and PPO configs.Isaac-Velocity-Rough-HeteroHumanoid-v0with a 187-point raycast height scanner (h2_scanneron the pelvis) and procedural terrain curriculum. (Note: Environment registration and sensory infrastructure are complete; tuning policy convergence on rough terrain will be addressed in a dedicated follow-up).scripts/demos/visualize_all_robots.pyto include H2, scaling the multi-robot showcase to 13 robots (8 quadrupeds + 5 humanoids).File Overview
source/isaaclab_assets/isaaclab_assets/robots/unitree.py: Articulation configurations (H2_CFG,H2_MINIMAL_CFG) with natural-frequency actuator models and nominal standing pose.source/isaaclab_tasks/isaaclab_tasks/direct/hetero_humanoid/robot_configs.py: Canonical 31-DOF joint slots, base link (pelvis), orientation limits, and illegal contact definitions for H2.source/isaaclab_tasks/isaaclab_tasks/direct/hetero_humanoid/hetero_humanoid_env.py: Corrected roll sign logic, per-robot root height terminations, and height scanner support for H2.source/isaaclab_tasks/isaaclab_tasks/direct/hetero_humanoid/hetero_humanoid_rewards.py: Scalable biped gait-symmetry reward function.source/isaaclab_tasks/isaaclab_tasks/direct/hetero_humanoid/hetero_humanoid_velocity_env_cfg.py: Sensor configurations, action/observation dimension handling, and tuned H2 reward terms.source/isaaclab_tasks/isaaclab_tasks/manager_based/locomotion/velocity/config/h2/: Flat and rough manager-based environment configurations and PPO runner parameters.scripts/tools/download_h2_assets.py: Asset helper to download and verify Unitree H2 USD assets.scripts/demos/visualize_all_robots.py&cli_args.py: Updated visualization demo and CLI argument choices (--humanoids).Visuals:
Screencast.from.2026-09-21.10-00-26.webm
How to Run
1. Direct RL Environment (Flat Terrain):
2. Manager-Based Environment (Flat Terrain):
3. Universal Multi-Robot Visualization:
Type of change
Checklist
pre-commitchecks with./isaaclab.sh --formatCONTRIBUTORS.mdor my name already exists there