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

Fixes camera MDP term name and reprojection docstrings #1130

Merged
merged 13 commits into from
Oct 4, 2024

Conversation

Mayankm96
Copy link
Contributor

@Mayankm96 Mayankm96 commented Oct 3, 2024

Description

For all observation-related terms, we follow the noun name for the function. However, the camera one was called grab_images. This MR renames it to image to make it consistent with the others.

Also the docstring for the math-utils were messed up. According to Google's docstyle, the first line should be a short summary and a detailed summary should move to the next paragraph. This MR fixes that as well.

Lastly, the name of the function convert_perspective_depth_to_orthoginal_depth has too much redundancy. The MR renames it to orthogonalize_perpsective_depth.

All these are breaking changes with no backwards compatibility (since they were added post-last release anyway).

Type of change

  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • 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

@@ -988,12 +988,7 @@ def transform_points(

@torch.jit.script
def unproject_depth(depth: torch.Tensor, intrinsics: torch.Tensor) -> torch.Tensor:
Copy link
Collaborator

@glvov-bdai glvov-bdai Oct 3, 2024

Choose a reason for hiding this comment

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

Although it mentions in the doc string that depth here should be orthogonal maybe good to also mention it in the method name like unproject_orthogonal_depth as I feel like the doc string comment could be missed

Copy link
Contributor Author

@Mayankm96 Mayankm96 Oct 4, 2024

Choose a reason for hiding this comment

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

I added a parameter to the function which user can set as True/False for orthogonal/perspective depth image respectively. This is probably less breaking.

Copy link
Collaborator

@glvov-bdai glvov-bdai left a comment

Choose a reason for hiding this comment

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

lgtm

@Mayankm96 Mayankm96 merged commit 4ce87f8 into main Oct 4, 2024
3 of 4 checks passed
@Mayankm96 Mayankm96 deleted the fix/docs-camera-funcs branch October 4, 2024 06:38
iamdrfly pushed a commit to iamdrfly/IsaacLab that referenced this pull request Nov 21, 2024
# Description

For all observation-related terms, we follow the noun name for the
function. However, the camera one was called `grab_images`. This MR
renames it to `image` to make it consistent with the others.

Also the docstring for the math-utils were messed up. According to
Google's docstyle, the first line should be a short summary and a
detailed summary should move to the next paragraph. This MR fixes that
as well.

Lastly, the name of the function
`convert_perspective_depth_to_orthoginal_depth` has too much redundancy.
The MR renames it to `orthogonalize_perpsective_depth`.

All these are breaking changes with no backwards compatibility (since
they were added post-last release anyway).

## Type of change

- Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- This change requires a documentation update

## 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
- [ ] 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

---------

Signed-off-by: Mayank Mittal <12863862+Mayankm96@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants