docs: HF model card — best-of-both front-matter derived from manifest
Browse files
README.md
CHANGED
|
@@ -1,12 +1,22 @@
|
|
| 1 |
---
|
| 2 |
-
tags:
|
| 3 |
-
- OpenRAL
|
| 4 |
-
- rskill
|
| 5 |
-
- ros2
|
| 6 |
-
- moveit
|
| 7 |
-
license: apache-2.0
|
| 8 |
language:
|
| 9 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
---
|
| 11 |
|
| 12 |
# rskill-moveit-joints
|
|
@@ -16,7 +26,7 @@ language:
|
|
| 16 |
> collision-free joint-space motion planning through the same
|
| 17 |
> `ExecuteRskill` path used by VLA skills. No model weights — the manifest
|
| 18 |
> is the entire artefact. Renamed from `openral/rskill-moveit-plan-arm`
|
| 19 |
-
> under [ADR-
|
| 20 |
|
| 21 |
This package uses `kind: ros_action` (see
|
| 22 |
[ADR-0024](../../docs/adr/0024-ros-wrapped-rskills.md)) — a discriminator
|
|
@@ -24,7 +34,7 @@ on `RSkillManifest.kind` that selects the
|
|
| 24 |
[`ROSActionRskill`](../../python/rskill/src/openral_rskill/ros_action_rskill.py)
|
| 25 |
engine at resolve time, with `ros_integration.goal_builder: joint` selecting
|
| 26 |
the [`JointGoalRskill`](../../python/rskill/src/openral_rskill/joint_goal_rskill.py)
|
| 27 |
-
goal-lowering adapter (ADR-
|
| 28 |
`rclpy.action.ActionClient` on the host `RskillRunnerNode`, sends one goal
|
| 29 |
built from `ros_integration.default_goal_json`, awaits the result, and replays
|
| 30 |
the returned `trajectory_msgs/JointTrajectory` one waypoint per `step()` call
|
|
@@ -99,6 +109,18 @@ Packing the full trajectory as one chunk with `horizon=N` would let
|
|
| 99 |
waypoints 1..N actuate unchecked — unacceptable for a planner whose
|
| 100 |
job is to thread between joint-limit walls.
|
| 101 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 102 |
## How it was trained / Upstream provenance
|
| 103 |
|
| 104 |
Nothing is trained — this rSkill wraps the upstream MoveIt motion
|
|
@@ -211,7 +233,7 @@ are commercial-use-permissive.
|
|
| 211 |
|
| 212 |
## See also
|
| 213 |
|
| 214 |
-
- [ADR-
|
| 215 |
- [ADR-0024 — ROS-wrapped rSkills](../../docs/adr/0024-ros-wrapped-rskills.md)
|
| 216 |
- [`openral_rskill.ros_action_rskill`](../../python/rskill/src/openral_rskill/ros_action_rskill.py) — engine source
|
| 217 |
- [`openral_rskill.joint_goal_rskill`](../../python/rskill/src/openral_rskill/joint_goal_rskill.py) — goal-lowering adapter
|
|
|
|
| 1 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
language:
|
| 3 |
+
- en
|
| 4 |
+
license: apache-2.0
|
| 5 |
+
pipeline_tag: robotics
|
| 6 |
+
tags:
|
| 7 |
+
- OpenRAL
|
| 8 |
+
- rskill
|
| 9 |
+
- ros2
|
| 10 |
+
- moveit
|
| 11 |
+
- franka_panda
|
| 12 |
+
- ur5e
|
| 13 |
+
- ur10e
|
| 14 |
+
- so100_follower
|
| 15 |
+
- openarm
|
| 16 |
+
- rizon4
|
| 17 |
+
- sawyer
|
| 18 |
+
- widowx
|
| 19 |
+
inference: false
|
| 20 |
---
|
| 21 |
|
| 22 |
# rskill-moveit-joints
|
|
|
|
| 26 |
> collision-free joint-space motion planning through the same
|
| 27 |
> `ExecuteRskill` path used by VLA skills. No model weights — the manifest
|
| 28 |
> is the entire artefact. Renamed from `openral/rskill-moveit-plan-arm`
|
| 29 |
+
> under [ADR-0054](../../docs/adr/0054-moveit-goal-builder-library.md).
|
| 30 |
|
| 31 |
This package uses `kind: ros_action` (see
|
| 32 |
[ADR-0024](../../docs/adr/0024-ros-wrapped-rskills.md)) — a discriminator
|
|
|
|
| 34 |
[`ROSActionRskill`](../../python/rskill/src/openral_rskill/ros_action_rskill.py)
|
| 35 |
engine at resolve time, with `ros_integration.goal_builder: joint` selecting
|
| 36 |
the [`JointGoalRskill`](../../python/rskill/src/openral_rskill/joint_goal_rskill.py)
|
| 37 |
+
goal-lowering adapter (ADR-0054). The adapter constructs an
|
| 38 |
`rclpy.action.ActionClient` on the host `RskillRunnerNode`, sends one goal
|
| 39 |
built from `ros_integration.default_goal_json`, awaits the result, and replays
|
| 40 |
the returned `trajectory_msgs/JointTrajectory` one waypoint per `step()` call
|
|
|
|
| 109 |
waypoints 1..N actuate unchecked — unacceptable for a planner whose
|
| 110 |
job is to thread between joint-limit walls.
|
| 111 |
|
| 112 |
+
### GPU-accelerated planning (cuMotion, ADR-0065)
|
| 113 |
+
|
| 114 |
+
On a host that clears the cuMotion GPU floor (`RobotCapabilities.supports_cumotion()`
|
| 115 |
+
— Ampere+, CUDA ≥ 13, ~8 GB VRAM), the runner sets
|
| 116 |
+
`MotionPlanRequest.pipeline_id = "isaac_ros_cumotion"` so MoveIt plans with
|
| 117 |
+
NVIDIA's CUDA-accelerated cuMotion pipeline; otherwise it falls back to OMPL.
|
| 118 |
+
Transparent — same skill, no manifest change — and it never bypasses the safety
|
| 119 |
+
kernel: the planned trajectory still replays through `/openral/candidate_action`
|
| 120 |
+
and is validated waypoint-by-waypoint. Install: see
|
| 121 |
+
[`docs/contributing/toolchain.md`](../../docs/contributing/toolchain.md) →
|
| 122 |
+
"GPU motion planning — cuMotion".
|
| 123 |
+
|
| 124 |
## How it was trained / Upstream provenance
|
| 125 |
|
| 126 |
Nothing is trained — this rSkill wraps the upstream MoveIt motion
|
|
|
|
| 233 |
|
| 234 |
## See also
|
| 235 |
|
| 236 |
+
- [ADR-0054 — MoveIt goal-builder library + rskill-moveit-* rename](../../docs/adr/0054-moveit-goal-builder-library.md)
|
| 237 |
- [ADR-0024 — ROS-wrapped rSkills](../../docs/adr/0024-ros-wrapped-rskills.md)
|
| 238 |
- [`openral_rskill.ros_action_rskill`](../../python/rskill/src/openral_rskill/ros_action_rskill.py) — engine source
|
| 239 |
- [`openral_rskill.joint_goal_rskill`](../../python/rskill/src/openral_rskill/joint_goal_rskill.py) — goal-lowering adapter
|