Skip to content

Conversation

@Nyquist0
Copy link
Collaborator

Summary

Adjusting object's pose is a classic and basic task in many complicated tasks, like pick-and-place, assembly, and manipulation. This PR introduces an AdjustPoseTask as a reusable task component and provides a concrete example environment (AdjustCubePoseEnvironment) that demonstrates how to use it.

Detailed description

What was the reason for the change?

The arena framework needed a fundamental task type for object pose adjustment that can be used as a building block for more complex manipulation tasks. Many robotic manipulation scenarios require moving an object to a specific position and/or orientation, so having a standardized task definition helps maintain consistency and reusability.

What has been changed?

  1. New Task:
  • Added AdjustPoseTask in isaaclab_arena/tasks/adjust_pose_task.py - a configurable task that defines success criteria based on:
    • Position constraints: Optional bounding box defined by x_range, y_range, and z_range
    • Orientation constraints: Target quaternion with angular tolerance (in radians)
  1. New Termination Logic:
  • Added adjust_pose_task_termination function in isaaclab_arena/tasks/terminations.py that evaluates whether the object has reached the target pose
  1. New Assets:
  • Added DexCube object to the object library
  • Added FactoryTableBackground to the background library
  1. New Example Environment:
  • Added AdjustCubePoseEnvironment in isaaclab_arena_environments/adjust_cube_pose_environment.py - a complete example showing how to configure and use the task with a Franka robot manipulating a cube
  1. Tests:
  • Added comprehensive tests in isaaclab_arena/tests/test_adjust_cube_pose.py:
    • Tests initial state (cube should not be in success state)
    • Tests success state (cube moved to target pose)
    • Tests multiple environments in parallel

What is the impact of this change?

  • New capability: Users can now create object pose adjustment tasks with flexible success criteria (position zone + orientation tolerance)
  • Reusable components: The AdjustPoseTask can be reused for various manipulation scenarios
  • New assets: DexCube and FactoryTableBackground are now available in the asset library for other environments

alexmillane and others added 7 commits December 8, 2025 13:15
## Summary
Update link to the docs in README.md to the new public location.

## Detailed description
- Docs url has changed now that the repo is public.
Doc fix
([MR](6c305d4))
& parallel eval
([MR](5d97a8f))
are cherrypicked in this MR.

---------

Co-authored-by: Vikram Ramasamy <[email protected]>
## Summary
Move the multi-versioned docs now that we have multiple version of Isaac
Lab Arena.

## Detailed description
- Means users can read the version of the docs that shipped the release
that they're using.

<img width="1130" height="625" alt="version_sidebar"
src="https://github.com/user-attachments/assets/b06372cd-9bed-4a1d-99b8-9480c279ebb4"
/>

## Summary
Short description of the change (max 50 chars)

## Detailed description
- What was the reason for the change?
- What has been changed?
- What is the impact of this change?

Co-authored-by: Alex Millane <[email protected]>
## Summary
Point to correct docs

---------

Co-authored-by: Alex Millane <[email protected]>
## Summary
Add warnings
Add corresponding example: adjust cube pose
@alexmillane alexmillane changed the base branch from release/0.1.1 to main December 18, 2025 17:27
Copy link
Collaborator

@alexmillane alexmillane left a comment

Choose a reason for hiding this comment

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

Thank you for adding this. I left a few comments. Once you've addressed them, merge away!

@Nyquist0 Nyquist0 enabled auto-merge (squash) December 23, 2025 07:29
@Nyquist0 Nyquist0 disabled auto-merge December 23, 2025 08:35
@Nyquist0 Nyquist0 enabled auto-merge (squash) December 23, 2025 08:57
@Nyquist0 Nyquist0 merged commit 1a2abef into main Dec 24, 2025
5 checks passed
@Nyquist0 Nyquist0 deleted the lance/feature/adjust_pose_task branch December 24, 2025 06:35
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.

5 participants