Skip to content

Commit 28f1cfb

Browse files
Clarify Xacro and package URI handling
1 parent fae3b50 commit 28f1cfb

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

docs/source/api/lab/isaaclab.sim.converters.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,11 @@ URDF Converter
5454
xacro path/to/robot.urdf.xacro > path/to/robot.urdf
5555
uv run python scripts/tools/convert_urdf.py path/to/robot.urdf path/to/output_dir
5656
57-
Any Xacro arguments and ROS package substitutions must therefore be resolved during the Xacro expansion
58-
step. The resulting URDF can then use the normal :class:`UrdfConverterCfg` options for collision geometry,
59-
joint drives, fixed-joint merging, and USD output.
57+
Xacro expansion resolves macros and Xacro arguments, but it does not generally resolve ``package://`` mesh
58+
URLs in the generated URDF. Rewrite those URLs to resolvable filesystem paths before using the CLI, or use
59+
the Python API and provide package mappings through :attr:`UrdfConverterCfg.ros_package_paths`. The resulting
60+
URDF can then use the normal :class:`UrdfConverterCfg` options for collision geometry, joint drives,
61+
fixed-joint merging, and USD output.
6062

6163
.. autoclass:: UrdfConverter
6264
:members:

0 commit comments

Comments
 (0)