Skip to content

Commit 70a5ffc

Browse files
Adds joint effort observation (#2211)
# Description <!-- Thank you for your interest in sending a pull request. Please make sure to check the contribution guidelines. Link: https://isaac-sim.github.io/IsaacLab/main/source/refs/contributing.html --> This PR adds in a joint_effort observation that exposes the `articulation.data.applied_effort` Fixes # (issue) <!-- As a practice, it is recommended to open an issue to have discussions on the proposed pull request. This makes it easier for the community to keep track of what is being developed or added, and if a given feature is demanded by more than one party. --> ## Type of change <!-- As you go through the list, delete the ones that are not applicable. --> - New feature (non-breaking change which adds functionality) <!-- Example: | Before | After | | ------ | ----- | | _gif/png before_ | _gif/png after_ | To upload images to a PR -- simply drag and drop an image while in edit mode and it should upload the image directly. You can then paste that source into the above before/after sections. --> ## Checklist - [x] I have run the [`pre-commit` checks](https://pre-commit.com/) with `./isaaclab.sh --format` - [x] I have made corresponding changes to the documentation - [x] My changes generate no new warnings - [ ] I have added tests that prove my fix is effective or that my feature works - [x] I have updated the changelog and the corresponding version in the extension's `config/extension.toml` file - [x] I have added my name to the `CONTRIBUTORS.md` or my name already exists there <!-- As you go through the checklist above, you can mark something as done by putting an x character in it For example, - [x] I have done this task - [ ] I have not done this task --> --------- Signed-off-by: Kelly Guo <kellyg@nvidia.com> Signed-off-by: Kelly Guo <kellyguo123@hotmail.com> Co-authored-by: Kelly Guo <kellyg@nvidia.com> Co-authored-by: Kelly Guo <kellyguo123@hotmail.com>
1 parent 1393f3b commit 70a5ffc

File tree

3 files changed

+27
-1
lines changed

3 files changed

+27
-1
lines changed

source/isaaclab/config/extension.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[package]
22

33
# Note: Semantic Versioning is used: https://semver.org/
4-
version = "0.37.0"
4+
version = "0.38.0"
55

66
# Description
77
title = "Isaac Lab framework for Robot Learning"

source/isaaclab/docs/CHANGELOG.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,15 @@
11
Changelog
22
---------
33

4+
0.38.0 (2025-04-01)
5+
~~~~~~~~~~~~~~~~~~
6+
7+
Added
8+
~~~~~
9+
10+
* Added the :meth:`~isaaclab.env.mdp.observations.joint_effort`
11+
12+
413
0.37.0 (2025-04-01)
514
~~~~~~~~~~~~~~~~~~~
615

source/isaaclab/isaaclab/envs/mdp/observations.py

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -209,6 +209,23 @@ def joint_vel_rel(env: ManagerBasedEnv, asset_cfg: SceneEntityCfg = SceneEntityC
209209
return asset.data.joint_vel[:, asset_cfg.joint_ids] - asset.data.default_joint_vel[:, asset_cfg.joint_ids]
210210

211211

212+
def joint_effort(env: ManagerBasedEnv, asset_cfg: SceneEntityCfg = SceneEntityCfg("robot")) -> torch.Tensor:
213+
"""The joint applied effort of the robot.
214+
215+
NOTE: Only the joints configured in :attr:`asset_cfg.joint_ids` will have their effort returned.
216+
217+
Args:
218+
env: The environment.
219+
asset_cfg: The SceneEntity associated with this observation.
220+
221+
Returns:
222+
The joint effort (N or N-m) for joint_names in asset_cfg, shape is [num_env,num_joints].
223+
"""
224+
# extract the used quantities (to enable type-hinting)
225+
asset: Articulation = env.scene[asset_cfg.name]
226+
return asset.data.applied_torque[:, asset_cfg.joint_ids]
227+
228+
212229
"""
213230
Sensors.
214231
"""

0 commit comments

Comments
 (0)