# cyber-fusion/ayg_description architecture

> Architecture diagram of the GitHub repository cyber-fusion/ayg_description, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyber-fusion/ayg_description
- Repository: https://github.com/cyber-fusion/ayg_description

## Overview

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: [`urdf/ayg.xacro`](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg.xacro) (Xacro dispatcher), [`launch/rviz.launch.py`](https://github.com/cyber-fusion/ayg_description/blob/main/launch/rviz.launch.py) (RViz launch), [`urdf/ayg1.2.xacro`](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.2.xacro) (1.2 model root), [`urdf/ayg1.3.xacro`](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.3.xacro) (1.3 model root)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_description["Robot descriptions"]
  node_dispatcher["Xacro dispatcher<br/>[ayg.xacro]"]
  node_root12["1.2 model root<br/>[ayg1.2.xacro]"]
  node_legs12["1.2 legs<br/>[legs.xacro]"]
  node_camera12["D555 camera<br/>[camera.xacro]"]
  node_initial12["1.2 initial pose"]
  node_root13["1.3 model root<br/>[ayg1.3.xacro]"]
  node_legs13["1.3 legs<br/>[legs.xacro]"]
  node_lidar13["JT128 lidar frame<br/>[lidar.xacro]"]
  node_initial13["1.3 initial pose"]
  node_simcontrol["Simulation control block"]
  node_flat12["1.2 flat URDF<br/>[ayg1.2.urdf]"]
  node_flat13["1.3 flat URDF<br/>[ayg1.3.urdf]"]
end

subgraph group_assets["Model assets"]
  node_meshes12["1.2 meshes<br/>[1.2]"]
  node_meshes13["1.3 meshes<br/>[1.3]"]
end

subgraph group_simulation["Simulation and visualization"]
  node_mujoco12["1.2 MuJoCo model<br/>[ayg.xml]"]
  node_mujoco13["1.3 MuJoCo model<br/>[ayg.xml]"]
  node_config12["1.2 RViz config<br/>[config.rviz]"]
  node_config13["1.3 RViz config<br/>[config.rviz]"]
end

subgraph group_runtime["ROS 2 runtime"]
  node_launch["RViz launch<br/>[rviz.launch.py]"]
  node_rsp["Robot state publisher"]
  node_jointgui["Joint state GUI"]
  node_rviz["RViz"]
end

node_engineer(("Robot developer"))

node_engineer -->|"selects model"| node_dispatcher
node_dispatcher -->|"selects version"| node_root12
node_dispatcher -->|"selects version"| node_root13
node_root12 -->|"includes legs"| node_legs12
node_root12 -->|"includes optionally"| node_camera12
node_root12 -->|"uses pose"| node_initial12
node_root13 -->|"includes legs"| node_legs13
node_root13 -->|"includes optionally"| node_lidar13
node_root13 -->|"uses pose"| node_initial13
node_root12 -->|"adds for simulation"| node_simcontrol
node_root13 -->|"adds for simulation"| node_simcontrol
node_dispatcher -->|"selects assets"| node_meshes12
node_dispatcher -->|"selects assets"| node_meshes13
node_dispatcher -->|"selects version"| node_mujoco12
node_dispatcher -->|"selects version"| node_mujoco13
node_engineer -->|"starts visualization"| node_launch
node_launch -->|"runs Xacro"| node_dispatcher
node_launch -->|"starts publisher"| node_rsp
node_launch -->|"starts GUI"| node_jointgui
node_launch -->|"starts viewer"| node_rviz
node_launch -->|"selects by version"| node_config12
node_launch -->|"selects by version"| node_config13
node_dispatcher -->|"generates URDF"| node_flat12
node_dispatcher -->|"generates URDF"| node_flat13

click node_dispatcher "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg.xacro"
click node_root12 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.2.xacro"
click node_legs12 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/legs.xacro"
click node_camera12 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/camera.xacro"
click node_initial12 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/initial_configuration.xacro"
click node_root13 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.3.xacro"
click node_legs13 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/legs.xacro"
click node_lidar13 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/lidar.xacro"
click node_initial13 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/initial_configuration.xacro"
click node_simcontrol "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/sim_ros2_control.xacro"
click node_flat12 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.2.urdf"
click node_flat13 "https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.3.urdf"
click node_meshes12 "https://github.com/cyber-fusion/ayg_description/tree/main/meshes/1.2"
click node_meshes13 "https://github.com/cyber-fusion/ayg_description/tree/main/meshes/1.3"
click node_mujoco12 "https://github.com/cyber-fusion/ayg_description/blob/main/mujoco/1.2/ayg.xml"
click node_mujoco13 "https://github.com/cyber-fusion/ayg_description/blob/main/mujoco/1.3/ayg.xml"
click node_launch "https://github.com/cyber-fusion/ayg_description/blob/main/launch/rviz.launch.py"
click node_config12 "https://github.com/cyber-fusion/ayg_description/blob/main/config/1.2/config.rviz"
click node_config13 "https://github.com/cyber-fusion/ayg_description/blob/main/config/1.3/config.rviz"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dispatcher,node_root12,node_legs12,node_camera12,node_initial12,node_root13,node_legs13,node_lidar13,node_initial13,node_simcontrol,node_flat12,node_flat13 toneBlue
class node_meshes12,node_meshes13 toneAmber
class node_mujoco12,node_mujoco13,node_config12,node_config13 toneMint
class node_launch,node_rsp,node_jointgui,node_rviz toneRose
class node_engineer toneIndigo
```

## Components

### Robot descriptions

- [Xacro dispatcher](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg.xacro): `urdf/ayg.xacro`
- [1.2 model root](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.2.xacro): `urdf/ayg1.2.xacro`
- [1.2 legs](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/legs.xacro): `urdf/1.2/legs.xacro`
- [D555 camera](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/camera.xacro): `urdf/1.2/camera.xacro`
- [1.2 initial pose](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.2/initial_configuration.xacro): `urdf/1.2/initial_configuration.xacro`
- [1.3 model root](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.3.xacro): `urdf/ayg1.3.xacro`
- [1.3 legs](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/legs.xacro): `urdf/1.3/legs.xacro`
- [JT128 lidar frame](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/lidar.xacro): `urdf/1.3/lidar.xacro`
- [1.3 initial pose](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/1.3/initial_configuration.xacro): `urdf/1.3/initial_configuration.xacro`
- [Simulation control block](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/sim_ros2_control.xacro): `urdf/sim_ros2_control.xacro`
- [1.2 flat URDF](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.2.urdf): `urdf/ayg1.2.urdf`
- [1.3 flat URDF](https://github.com/cyber-fusion/ayg_description/blob/main/urdf/ayg1.3.urdf): `urdf/ayg1.3.urdf`

### Model assets

- [1.2 meshes](https://github.com/cyber-fusion/ayg_description/tree/main/meshes/1.2): `meshes/1.2`
- [1.3 meshes](https://github.com/cyber-fusion/ayg_description/tree/main/meshes/1.3): `meshes/1.3`

### Simulation and visualization

- [1.2 MuJoCo model](https://github.com/cyber-fusion/ayg_description/blob/main/mujoco/1.2/ayg.xml): `mujoco/1.2/ayg.xml`
- [1.3 MuJoCo model](https://github.com/cyber-fusion/ayg_description/blob/main/mujoco/1.3/ayg.xml): `mujoco/1.3/ayg.xml`
- [1.2 RViz config](https://github.com/cyber-fusion/ayg_description/blob/main/config/1.2/config.rviz): `config/1.2/config.rviz`
- [1.3 RViz config](https://github.com/cyber-fusion/ayg_description/blob/main/config/1.3/config.rviz): `config/1.3/config.rviz`

### ROS 2 runtime

- [RViz launch](https://github.com/cyber-fusion/ayg_description/blob/main/launch/rviz.launch.py): `launch/rviz.launch.py`
- **Robot state publisher**
- **Joint state GUI**
- **RViz**

### Other components

- **Robot developer**

## Connections

- 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 (evidence: `launch/rviz.launch.py`)
- RViz launch → Robot state publisher: starts publisher (evidence: `launch/rviz.launch.py`)
- RViz launch → Joint state GUI: starts GUI (evidence: `launch/rviz.launch.py`)
- RViz launch → RViz: starts viewer (evidence: `launch/rviz.launch.py`)
- RViz launch → 1.2 RViz config: selects by version (evidence: `launch/rviz.launch.py`)
- RViz launch → 1.3 RViz config: selects by version (evidence: `launch/rviz.launch.py`)
- Xacro dispatcher → 1.2 flat URDF: generates URDF
- Xacro dispatcher → 1.3 flat URDF: generates URDF
