Name | Modified | Size | Downloads / Week |
---|---|---|---|
Parent folder | |||
README.md | 2025-07-30 | 18.4 kB | |
v2.1.1 source code.tar.gz | 2025-07-30 | 32.0 MB | |
v2.1.1 source code.zip | 2025-07-30 | 33.2 MB | |
Totals: 3 Items | 65.2 MB | 0 |
👀 Overview
This release has been in development over the past few months and includes a significant number of updates, enhancements, and new features across the entire codebase. Given the volume of changes, we've grouped them into relevant categories to improve readability. This version is compatible with NVIDIA Isaac Sim 4.5.
We appreciate the community’s patience and contributions in ensuring quality and stability throughout. We're aiming for more frequent patch releases moving forward to improve the developer experience.
Note: This minor release does not include a Docker image or pip package.
Full Changelog: https://github.com/isaac-sim/IsaacLab/compare/v2.1.0...v2.1.1
✨ New Features
- Asset Interfaces
- Adds
position
argument to set external forces and torques at different locations on the rigid body by @AntoineRichard in https://github.com/isaac-sim/IsaacLab/pull/1680 - Adds
body_incoming_joint_wrench_b
to ArticulationData field by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2128 - Allows selecting articulation root prim explicitly by @lgulich in https://github.com/isaac-sim/IsaacLab/pull/2228
- Sensor Interfaces
- Draws connection lines for FrameTransformer visualization by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/1754
- Uses visualization marker for connecting lines inside FrameTransformer by @bikcrum in https://github.com/isaac-sim/IsaacLab/pull/2526
- MDP Terms
- Adds
body_pose_w
andbody_projected_gravity_b
observations by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2212 - Adds joint effort observation by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2211
- Adds CoM randomization term to manager-based events by @shendredm in https://github.com/isaac-sim/IsaacLab/pull/1714
- Adds time-based mdp (observation) functions by @TheIndoorDad in https://github.com/isaac-sim/IsaacLab/pull/2332
- Adds curriculum mdp term to modify any environment parameters by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2777
- New Example Tasks
- Adds assembly tasks from the Automate project by @yijieg in https://github.com/isaac-sim/IsaacLab/pull/2507
- Adds digit locomotion examples by @lgulich in https://github.com/isaac-sim/IsaacLab/pull/1892
🔧 Improvements
Core API
- Actuator Interfaces
- Fixes implicit actuator limits configs for assets by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2952
- Updates actuator configs for Franka arm by @reeceomahoney in https://github.com/isaac-sim/IsaacLab/pull/2492
- Asset Interfaces
- Optimizes getters of data inside asset classes by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/2118
- Adds method to set the visibility of the Asset's prims by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/1752
- Sensor Interfaces
- Updates to ray caster ray alignment and more customizable drift sampling by @jsmith-bdai in https://github.com/isaac-sim/IsaacLab/pull/2556
- Extends ContactSensorData by
force_matrix_w_history
attribute by @bikcrum in https://github.com/isaac-sim/IsaacLab/pull/2916 - Adds IMU projected_gravity_b and IMU computation speed optimizations by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2512
- Manager Interfaces
- Adds serialization to observation and action managers by @jsmith-bdai in https://github.com/isaac-sim/IsaacLab/pull/2234
- Adds option to define the concatenation dimension in the
ObservationManager
by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2393 - Supports composite observation space with proper min max in manager based env by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2811
- Changes counter update in
CommandManager
by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2393 - Integrates
NoiseModel
to manager-based workflows by @ozhanozen in https://github.com/isaac-sim/IsaacLab/pull/2755 - Updates
NoiseModelWithAdditiveBias
to apply per-feature bias sampling by @ozhanozen in https://github.com/isaac-sim/IsaacLab/pull/2760 - Fixes
isaaclab.scene.reset_to
to properly accept None as valid argument by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2970 - Resets step reward buffer properly when weight is zero by @bikcrum in https://github.com/isaac-sim/IsaacLab/pull/2392
- Terrain Generation
- Allows for custom
TerrainGenerator
without modifications of theTerrainImporter
by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2487 - Adds option for terrain border to above or below the ground by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2394
- Adds ability to set platform height independent of object height for terrain by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2695
- Adds absolute and relative noise to
MeshRepeatedObjectsTerrain
by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2830 - Simulation
- Raises exceptions from initialization callbacks inside SimContext in https://github.com/isaac-sim/IsaacLab/pull/2166
- Applies
semantic_tags
to ground by @KumoLiu in https://github.com/isaac-sim/IsaacLab/pull/2410 - Sets
enable_stabilization
to false by default by @AntoineRichard in https://github.com/isaac-sim/IsaacLab/pull/2628 - Fixes deprecation warning for pxr.Semantics by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2721
- Math Utilities
- Improves the implementation of
euler_xyz_from_quat
by @ShaoshuSu in https://github.com/isaac-sim/IsaacLab/pull/2365 - Optimizes
yaw_quat
implementation by @hapatel-bdai in https://github.com/isaac-sim/IsaacLab/pull/2247 - Changes to
quat_apply
andquat_apply_inverse
for speed by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2129 - Changes
quat_box_minus
implementation by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2217 - Adds
quat_box_plus
andrigid_body_twist_transform
by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2217 - Adds math tests for transforms, rotations, and conversions by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2801
- General Utilities
- Simplifies buffer validation check for CircularBuffer by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/2617
- Modifies
update_class_from_dict()
to wholesale replace flat Iterables by @ozhanozen in https://github.com/isaac-sim/IsaacLab/pull/2511 - Allows slicing to be processed from lists inside dictionary by @LinghengMeng @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2853
Tasks API
- Adds support for
module:task
and updates gymnasium to >=1.0 by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2467 - Adds available RL library configs on error message if entry point is invalid by @Toni-SM in https://github.com/isaac-sim/IsaacLab/pull/2713
- Enables hydra for all play.py scripts by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2995
- Fixes ray lazy metric reporting and hanging processes by @ozhanozen in https://github.com/isaac-sim/IsaacLab/pull/2346
- Adds gradient clipping parameter for distillation using RSL-RL by @alessandroassirelli98 in https://github.com/isaac-sim/IsaacLab/pull/2454
- Makes GRU-based RNNs exportable in RSL RL by @WT-MM in https://github.com/isaac-sim/IsaacLab/pull/3009
- Adds wandb native support in rl_games by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2650
- Optimizes Stable-Baselines3 wrapper and additional training configs by @araffin in https://github.com/isaac-sim/IsaacLab/pull/2022
- Enables sb3 to load checkpoint to continue training by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2954
- Supports sb3 wrapper to pre-process env's image obs-space to trigger sb3 natively supported cnn creation pipeline by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2812
Infrastructure
- Dependencies
- Updates torch to 2.7.0 with cuda 12.8 blackwell support by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2998
- Updates gymnasium to v1.2.0 by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2852
- Fixes numpy ver to <2 for isaaclab_rl and isaaclab_tasks by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2866
- Adds license file for 3rd party OSS dependencies by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2577
- Sets robomimic version to v0.4.0 by @masoudmoghani in https://github.com/isaac-sim/IsaacLab/pull/2814
- Upgrades pillow dependencies for upcoming Kit 107.3.1 by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2908
- Removes protobuf upper version pin by @kwlzn in https://github.com/isaac-sim/IsaacLab/pull/2726
- Docker
- Uses
--gpus
instead of nvidia runtime for docker by @yanziz-nvidia in https://github.com/isaac-sim/IsaacLab/pull/2411 - Adds optional suffix parameter for docker name by @zoemcc in https://github.com/isaac-sim/IsaacLab/pull/2172
- Adds support for bash history in docker by @AntoineRichard in https://github.com/isaac-sim/IsaacLab/pull/2659
- Testing & Benchmarking
- Switches unittest to pytest for testing by @kellyguo11 @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2459
- Adds training benchmark unit tests with input config by @matthewtrepte in https://github.com/isaac-sim/IsaacLab/pull/2503
- Fixes failing environment and IK tests by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2372
- Repository Utilities
- Adds script to convert urdfs/meshes to instanceable USD in batches by @hapatel-bdai in https://github.com/isaac-sim/IsaacLab/pull/2248
- Adds citation link for the repository by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2935
- Adds Internal template generator warning for case when user pip installed isaaclab by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/3027
🐛 Bug Fixes
Core API
- Actuator Interfaces
- Fixes DCMotor clipping for negative power and adds actuator tests by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2300
- Asset Interfaces
- Fixes inconsistent data reading in body, link, com for RigidObject, RigidObjectCollection and Articulation by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2736
- Sensor Interfaces
- Fixes pose update in
Camera
andTiledCamera
by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2316 - Fixes moving to cpu if needed in camera.py by @renaudponcelet in https://github.com/isaac-sim/IsaacLab/pull/2176
- Fixes how camera intrinsics are used for creation and update by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/1624
- Manager Interfaces
- Fixes ObservationManager history buffer corrupted by external calls to ObservationManager.compute by @patrickhaoy in https://github.com/isaac-sim/IsaacLab/pull/2885
- Fixes check for manager term class inside event manager by @miguelalonsojr in https://github.com/isaac-sim/IsaacLab/pull/2357
- Fixes the issue of using Modifiers and history buffer together by @ZiwenZhuang in https://github.com/isaac-sim/IsaacLab/pull/2461
- Fixes check for re-initializing terms in ManagerBase by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/2612
- Fixes collision filtering logic on CPU by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2553
- Fixes import inside InteractiveScene and LiveVisualizer by @Mayankm96 in https://github.com/isaac-sim/IsaacLab/pull/2611
- Fixes broken import in Live Visualizer image plot by @pascal-roth in https://github.com/isaac-sim/IsaacLab/pull/2486
- MDP Terms
- Fixes shape mismatch in body COM randomization by @shendredm in https://github.com/isaac-sim/IsaacLab/pull/2561
- Fixes visual prims handling during texture randomization by @KumoLiu in https://github.com/isaac-sim/IsaacLab/pull/2476
- Resets joint position/velocity targets in
reset_scene_to_default
by @wghou in https://github.com/isaac-sim/IsaacLab/pull/2692 - Fixes joint out of position limits terminations by @GiulioRomualdi in https://github.com/isaac-sim/IsaacLab/pull/2442
- Fixes
reset_joints_by_scale
andreset_joints_by_offsets
to only affect thejoint_names
specified in SceneEntityCfg by @ooctipus in https://github.com/isaac-sim/IsaacLab/pull/2899 - Math Utilities
- Fixes the implementation of
quat_inv()
by @ozhanozen in https://github.com/isaac-sim/IsaacLab/pull/2797
Tasks API
- Fixes export LSTM to onnx file by @jtigue-bdai in https://github.com/isaac-sim/IsaacLab/pull/2821
Example Tasks
- Removes redundant contact termination assignment in
H1RoughEnvCfg
by @louislelay in https://github.com/isaac-sim/IsaacLab/pull/1748 - Fixes memory leak in SDF calculation by @leondavi in https://github.com/isaac-sim/IsaacLab/pull/2680
- Fixes
randomization
toevents
in Digit envs by @fan-ziqi in https://github.com/isaac-sim/IsaacLab/pull/3033
📜 Documentation
- Adds section on isaac sim version in README by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2698
- Adds physics performance how-to guide by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2468
- Adds walkthrough section in documentation with jetbot tutorial by @mpgussert in https://github.com/isaac-sim/IsaacLab/pull/2368
- Changes quickstart installation to use conda by @mpgussert in https://github.com/isaac-sim/IsaacLab/pull/2686
- Fixes typo in the docs for adding your own library by @norbertcygiert in https://github.com/isaac-sim/IsaacLab/pull/2520
- Updates documentation for conda, fabric, and inferencing by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2772
- Updates license headers and contributing with DCO by @kellyguo11 in https://github.com/isaac-sim/IsaacLab/pull/2629
- Updates help text and docs to reflect pytest usage by @louislelay in https://github.com/isaac-sim/IsaacLab/pull/2638
- Updates doc on actuators to include some references by @AntoineRichard in https://github.com/isaac-sim/IsaacLab/pull/2656
- Update documentation on pytorch multi gpu setup by @Alex-Omar-Nvidia in https://github.com/isaac-sim/IsaacLab/pull/2687
- Remove deprecated env variable in docs by @Kyu3224 in https://github.com/isaac-sim/IsaacLab/pull/2936
💔 Breaking Changes
While this release mainly focuses around various improvements and bug fixes, there are some noticeable behavior changes that are worth highlighting. These are summarized below.
Disabling of additional stabilization pass in PhysX settings
Previously, we were setting the PhysxCfg.enable_stabilization to True by default. This flag enabled additional stabilization processing by the underlying physics engine to improve the stability of complex interactions between large number of bodies.
As discussed in the PR [#2628], enabling this flag led to incorrect contact forces report. Under the hood, PhysX introduces various non-physical heuristics to perform stabilization of large number of contacts. However, since the solver has improved, these heuristics are no longer applicable or needed for robotics applications. Hence, we have changed the flag enable_stabilization
to False by default.
Clipping of torques inside the DC Motor
Previously, the clipping of torques inside the DC Motor did not account for the negative power regions properly. With the changes introduced in PR [#2300], this should be handled properly.
🤗 New Contributors
- @miguelalonsojr made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2357
- @renaudponcelet made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2176
- @yanziz-nvidia made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2411
- @KumoLiu made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2410
- @bikcrum made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2392
- @zoemcc made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2172
- @virgilio96upm made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/1716
- @ZiwenZhuang made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2461
- @reeceomahoney made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2492
- @shendredm made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/1714
- @matthewtrepte made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2503
- @yijieg made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2507
- @alessandroassirelli98 made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2454
- @TheIndoorDad made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2332
- @ooctipus made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2650
- @araffin made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2022
- @wghou made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2692
- @ShaoshuSu made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2365
- @norbertcygiert made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2520
- @leondavi made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2680
- @kwlzn made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2726
- @bsb808 made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2788
- @patrickhaoy made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2885
- @Kyu3224 made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2936
- @Alex-Omar-Nvidia made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/2687
- @WT-MM made their first contribution in https://github.com/isaac-sim/IsaacLab/pull/3009