How cyber-fusion/ayg_description works
This repository packages Ayg 1.2 and 1.3 robot descriptions and visualization/simulation assets. The main workflow is selecting a version and options in the Xacro dispatcher, assembling that model, then optionally launching it into ROS 2 state publishing and RViz. The README documents version-specific geometry, sensors, initial poses, and shared simulation support. Source excerpts are limited to the launch file, so Xacro relationships below rely on README documentation; unshown internal wiring is not inferred.
Main entry points: ayg.xacro Xacro dispatcher · rviz.launch.py RViz launch · ayg1.2.xacro 1.2 model root · ayg1.3.xacro 1.3 model root
Components 23
Robot descriptions
- Xacro dispatcher
urdf/ayg.xacro - 1.2 model root
urdf/ayg1.2.xacro - 1.2 legs
urdf/1.2/legs.xacro - D555 camera
urdf/1.2/camera.xacro - 1.2 initial pose
urdf/1.2/initial_configuration.xacro - 1.3 model root
urdf/ayg1.3.xacro - 1.3 legs
urdf/1.3/legs.xacro - JT128 lidar frame
urdf/1.3/lidar.xacro - 1.3 initial pose
urdf/1.3/initial_configuration.xacro - Simulation control block
urdf/sim_ros2_control.xacro - 1.2 flat URDF
urdf/ayg1.2.urdf - 1.3 flat URDF
urdf/ayg1.3.urdf
Model assets
- 1.2 meshes
meshes/1.2 - 1.3 meshes
meshes/1.3
Simulation and visualization
- 1.2 MuJoCo model
mujoco/1.2/ayg.xml - 1.3 MuJoCo model
mujoco/1.3/ayg.xml - 1.2 RViz config
config/1.2/config.rviz - 1.3 RViz config
config/1.3/config.rviz
ROS 2 runtime
- RViz launch
launch/rviz.launch.py - Robot state publisher
- Joint state GUI
- RViz
Other components
- Robot developer
Connections 24
- Robot developer → Xacro dispatcher: selects model
- Xacro dispatcher → 1.2 model root: selects version
- Xacro dispatcher → 1.3 model root: selects version
- 1.2 model root → 1.2 legs: includes legs
- 1.2 model root → D555 camera: includes optionally
- 1.2 model root → 1.2 initial pose: uses pose
- 1.3 model root → 1.3 legs: includes legs
- 1.3 model root → JT128 lidar frame: includes optionally
- 1.3 model root → 1.3 initial pose: uses pose
- 1.2 model root → Simulation control block: adds for simulation
- 1.3 model root → Simulation control block: adds for simulation
- Xacro dispatcher → 1.2 meshes: selects assets
- Xacro dispatcher → 1.3 meshes: selects assets
- Xacro dispatcher → 1.2 MuJoCo model: selects version
- Xacro dispatcher → 1.3 MuJoCo model: selects version
- Robot developer → RViz launch: starts visualization
- RViz launch → Xacro dispatcher: runs Xacro
launch/rviz.launch.py - RViz launch → Robot state publisher: starts publisher
launch/rviz.launch.py - RViz launch → Joint state GUI: starts GUI
launch/rviz.launch.py - RViz launch → RViz: starts viewer
launch/rviz.launch.py - RViz launch → 1.2 RViz config: selects by version
launch/rviz.launch.py - RViz launch → 1.3 RViz config: selects by version
launch/rviz.launch.py - Xacro dispatcher → 1.2 flat URDF: generates URDF
- Xacro dispatcher → 1.3 flat URDF: generates URDF