AdrianLlopart commited on
Commit
c4568ac
·
verified ·
1 Parent(s): 4f79593

docs: HF model card — best-of-both front-matter derived from manifest

Browse files
Files changed (1) hide show
  1. README.md +32 -10
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
- - en
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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-0052](../../docs/adr/0052-moveit-goal-builder-library.md).
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-0052). The adapter constructs an
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-0052 — MoveIt goal-builder library + rskill-moveit-* rename](../../docs/adr/0052-moveit-goal-builder-library.md)
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