Skills

Rerun Urdf

Drive the Rerun URDF API (rerun.urdf.UrdfTree) to ingest a URDF as a Transform3D layer...

Install

npx skills add rerun-io/rerun --skill rerun-urdf -g -a claude-code -y
Repository
rerun-io/rerun11.7k
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Mediumabout 3,000 tokens
Runs scripts
Yes, review before use

What it does

Drive the Rerun URDF API (rerun.urdf.UrdfTree) to ingest a URDF as a Transform3D layer on a robot recording. Read when logging a robot model, running forward kinematics from joint states, composing a fixed chain for sensor extrinsics, or when the transform tree will not connect from the data alone. Builds on rerun-chunk-processing (stream/lens mechanics) and rerun-data-model (entity paths, timeline, base-vs-layer).

Rerun URDF ingestion

A URDF gives you a robot's geometry and its kinematic tree. Ingesting it means two API calls on one rerun.urdf.UrdfTree: stream the static model, then drive it with forward kinematics from joint states. The transforms it produces are derived, so they are a layer, never base (the URDF + joints (computed) row of the rerun-data-model table).

This skill is the UrdfTree API and the two judgment calls it cannot make for you: how your joint values map to URDF joints, and how the disconnected frames in the scene connect to one root. The stream/lens plumbing (LazyChunkStream, DeriveLens, Selector, writing and optimizing RRDs) is in rerun-chunk-processing; reach for it, do not re-derive it. Nothing below is tied to a data format: where your joint names, joint values, and calibration come from is yours to wire in.

Getting the URDF

Datasets rarely ship one, and the robot's own repo is not always the fastest route. In order:

  • robot_descriptions.py, pip install robot_descriptions, then from robot_descriptions import ur5e_description; ur5e_description.URDF_PATH. It downloads and caches the upstream description and hands you a plain path with the meshes already next to it. Check its index first; it covers most of the table below.
  • The vendor repo, when the description is newer than the package's pin or is not in it.
  • MuJoCo Menagerie, MJCF, not URDF, so it needs conversion. Worth it only when nothing else exists.
Read the whole SKILL.md on GitHub

More in Engineering