Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adds documentation on the frames for asset data #742

Merged
merged 6 commits into from
Aug 2, 2024
Merged

Conversation

Mayankm96
Copy link
Contributor

@Mayankm96 Mayankm96 commented Jul 28, 2024

Description

This MR adds docstrings in articulation and rigid object data to clarify the exact frames they are reported in. This was previously causing confusion as PhysX reports the transforms in actor frame and velocities in CoM frame. Right now, there is no mechanism to get all this data in the same frame, so the best we can do is document behavior.

Type of change

  • This change requires a documentation update

Checklist

  • I have run the pre-commit checks with ./isaaclab.sh --format
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • I have updated the changelog and the corresponding version in the extension's config/extension.toml file
  • I have added my name to the CONTRIBUTORS.md or my name already exists there

@Mayankm96 Mayankm96 added the documentation Improvements or additions to documentation label Jul 28, 2024
@Mayankm96 Mayankm96 self-assigned this Jul 30, 2024
world frame unless otherwise specified.

For a rigid body, there are two frames of reference that are used:

- Actor frame: The frame of reference of the actor that contains the rigid body.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shall we mention that this coincides with the Xform on which the rigid body is attached?
I guess people do not necessarily know the concept of actors.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found xform frame in the docs to be a bit confusion. Left it as actor frame for now.

Mayankm96 and others added 2 commits July 30, 2024 19:55
Co-authored-by: David Hoeller <dhoeller@nvidia.com>
Signed-off-by: Mayank Mittal <12863862+Mayankm96@users.noreply.github.com>
@Mayankm96 Mayankm96 merged commit 59c0b2d into main Aug 2, 2024
2 of 3 checks passed
@Mayankm96 Mayankm96 deleted the fix/data-docs branch August 2, 2024 11:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants