Skip to content

Add docs for URDF Assembly Tool #174

Merged
yuecideng merged 2 commits intomainfrom
yueci/urdf-docs
Mar 11, 2026
Merged

Add docs for URDF Assembly Tool #174
yuecideng merged 2 commits intomainfrom
yueci/urdf-docs

Conversation

@yuecideng
Copy link
Contributor

Description

Add documentation for the URDF Assembly Tool
(docs/source/features/urdf_assembly.rst), addressing the feature request
in issue #109.

This new documentation covers:

  • Overview: What the URDF Assembly Tool does and its capabilities
  • Quick Start: Basic usage example showing how to add components and merge
    URDFs
  • Supported Components: List of robot component types (chassis, arms,
    hands, etc.)
  • Supported Sensors: Sensor types that can be attached (camera, lidar,
    IMU, GPS, force)
  • Connection Rules: How components are automatically connected
  • API Reference: Detailed documentation for URDFAssemblyManager methods
  • URDFCfg Integration: How to use the tool with URDFCfg for robot creation
    in simulation, including a complete example from
    scripts/tutorials/sim/create_robot.py
  • File Structure: Overview of the toolkit's module organization

Also includes minor typo fixes in the RL documentation (embodychain →
embodychchain).

Fixes #109

Type of change

  • Documentation update

Checklist

  • I have made corresponding changes to the documentation
  • Dependencies have been updated, if applicable.

@yuecideng yuecideng added the docs Improvements or additions to documentation label Mar 11, 2026
Copilot AI review requested due to automatic review settings March 11, 2026 15:50
@yuecideng yuecideng changed the title Yueci/urdf docs Add docs for URDF Assembly Tool Mar 11, 2026
@yuecideng yuecideng merged commit 2ed96c4 into main Mar 11, 2026
6 checks passed
@yuecideng yuecideng deleted the yueci/urdf-docs branch March 11, 2026 15:52
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR aligns naming across the RL training configs/code and documentation to the repository’s embodichain package name, and adds user documentation for the URDF Assembly toolkit.

Changes:

  • Update default and example Weights & Biases project names from embodychain-* to embodichain-*.
  • Fix RL overview documentation to use embodichain consistently.
  • Add a new “URDF Assembly Tool” documentation page and link it into the toolkits docs index.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
embodichain/agents/rl/train.py Updates default wandb_project_name to embodichain-generic.
configs/agents/rl/push_cube/train_config.json Renames W&B project to embodichain-push_cube.
configs/agents/rl/basic/cart_pole/train_config.json Renames W&B project to embodichain-cart_pole.
configs/agents/rl/basic/cart_pole/train_config_grpo.json Renames W&B project to embodichain-cart_pole.
docs/source/overview/rl/index.rst Updates prose references from embodychain to embodichain.
docs/source/features/toolkits/urdf_assembly.md Adds URDF Assembly toolkit documentation (needs import-name typo fixes).
docs/source/features/toolkits/index.rst Adds urdf_assembly page to the toolkits toctree.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

```python
from pathlib import Path
import numpy as np
from embedichain.toolkits.urdf_assembly import URDFAssemblyManager
Copy link

Copilot AI Mar 11, 2026

Choose a reason for hiding this comment

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

The package name in this code example is misspelled as embedichain. In this repo the Python package is embodichain, so readers copying this snippet will hit an ImportError. Please update the import to use embodichain consistently.

Suggested change
from embedichain.toolkits.urdf_assembly import URDFAssemblyManager
from embodichain.toolkits.urdf_assembly import URDFAssemblyManager

Copilot uses AI. Check for mistakes.
Comment on lines +212 to +251
```python
from embedichain.lab.sim.cfg import RobotCfg, URDFCfg

cfg = RobotCfg(
uid="my_robot",
urdf_cfg=URDFCfg(
components=[
{
"component_type": "arm",
"urdf_path": "path/to/arm.urdf",
},
{
"component_type": "hand",
"urdf_path": "path/to/hand.urdf",
"transform": hand_transform, # 4x4 transformation matrix
},
]
),
control_parts={...},
drive_pros={...},
)
```

### Complete Example

Here's a complete example from `scripts/tutorials/sim/create_robot.py`:

```python
import numpy as np
import torch
from scipy.spatial.transform import Rotation as R

from embedichain.lab.sim import SimulationManager, SimulationManagerCfg
from embedichain.lab.sim.objects import Robot
from embedichain.lab.sim.cfg import (
JointDrivePropertiesCfg,
RobotCfg,
URDFCfg,
)
from embedichain.data import get_data_path
Copy link

Copilot AI Mar 11, 2026

Choose a reason for hiding this comment

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

This section’s example imports RobotCfg/URDFCfg (and other modules) from embedichain.*, but the actual package in this repo is embodichain.*. Please fix these imports so the documentation examples are runnable as-written.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Proposal] Add URDF Assembly Tool Documentation

2 participants