# ros/urdf_sim_tutorial architecture

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

- Interactive diagram: https://gitdiagram.com/ros/urdf_sim_tutorial
- Repository: https://github.com/ros/urdf_sim_tutorial

## Overview

This is a small ROS URDF simulation tutorial package. Its principal workflow is launching a simulated robot assembled from URDF/Xacro descriptions, with staged examples for joints, the head, gripper, and differential drive. The README points to the upstream URDF tutorial; source excerpts do not show launch wiring or model composition, so those connections are not asserted.

Main entry points: [`launch/gazebo.launch`](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/gazebo.launch) (Gazebo launch), [`launch/09-joints.launch`](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/09-joints.launch) (Joint launch), [`launch/10-head.launch`](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/10-head.launch) (Head launch), [`launch/12-gripper.launch`](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/12-gripper.launch) (Gripper launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch examples"]
  node_gazebo_launch["Gazebo launch<br/>[gazebo.launch]"]
  node_joints_launch["Joint launch<br/>[09-joints.launch]"]
  node_head_launch["Head launch<br/>[10-head.launch]"]
  node_gripper_launch["Gripper launch<br/>[12-gripper.launch]"]
  node_drive_launch["Drive launch"]
  node_joint_config["Joint config<br/>[joints.yaml]"]
  node_head_config["Head config<br/>[head.yaml]"]
  node_gripper_config["Gripper config<br/>[gripper.yaml]"]
  node_drive_config["Drive config<br/>[diffdrive.yaml]"]
end

subgraph group_model["Robot model"]
  node_joint_model["Joint model"]
  node_transmission_model["Transmission model"]
  node_limit_model["Limited transmission"]
  node_gripper_model["Gripper model"]
  node_drive_model["Drive model"]
end

node_user(("ROS user"))
node_simulator["Gazebo simulator"]

node_user -->|"starts"| node_gazebo_launch
node_user -->|"starts"| node_joints_launch
node_user -->|"starts"| node_head_launch
node_user -->|"starts"| node_gripper_launch
node_user -->|"starts"| node_drive_launch

click node_gazebo_launch "https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/gazebo.launch"
click node_joints_launch "https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/09-joints.launch"
click node_head_launch "https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/10-head.launch"
click node_gripper_launch "https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/12-gripper.launch"
click node_drive_launch "https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/13-diffdrive.launch"
click node_joint_model "https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/09-publishjoints.urdf.xacro"
click node_transmission_model "https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/10-firsttransmission.urdf.xacro"
click node_limit_model "https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/11-limittransmission.urdf.xacro"
click node_gripper_model "https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/12-gripper.urdf.xacro"
click node_drive_model "https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/13-diffdrive.urdf.xacro"
click node_joint_config "https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/joints.yaml"
click node_head_config "https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/head.yaml"
click node_gripper_config "https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/gripper.yaml"
click node_drive_config "https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/diffdrive.yaml"

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_gazebo_launch,node_joints_launch,node_head_launch,node_gripper_launch,node_drive_launch,node_joint_config,node_head_config,node_gripper_config,node_drive_config,node_user toneBlue
class node_joint_model,node_transmission_model,node_limit_model,node_gripper_model,node_drive_model toneAmber
class node_simulator toneIndigo
```

## Components

### Launch examples

- [Gazebo launch](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/gazebo.launch): `launch/gazebo.launch`
- [Joint launch](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/09-joints.launch): `launch/09-joints.launch`
- [Head launch](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/10-head.launch): `launch/10-head.launch`
- [Gripper launch](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/12-gripper.launch): `launch/12-gripper.launch`
- [Drive launch](https://github.com/ros/urdf_sim_tutorial/blob/ros1/launch/13-diffdrive.launch): `launch/13-diffdrive.launch`
- [Joint config](https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/joints.yaml): `config/joints.yaml`
- [Head config](https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/head.yaml): `config/head.yaml`
- [Gripper config](https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/gripper.yaml): `config/gripper.yaml`
- [Drive config](https://github.com/ros/urdf_sim_tutorial/blob/ros1/config/diffdrive.yaml): `config/diffdrive.yaml`

### Robot model

- [Joint model](https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/09-publishjoints.urdf.xacro): `urdf/09-publishjoints.urdf.xacro`
- [Transmission model](https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/10-firsttransmission.urdf.xacro): `urdf/10-firsttransmission.urdf.xacro`
- [Limited transmission](https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/11-limittransmission.urdf.xacro): `urdf/11-limittransmission.urdf.xacro`
- [Gripper model](https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/12-gripper.urdf.xacro): `urdf/12-gripper.urdf.xacro`
- [Drive model](https://github.com/ros/urdf_sim_tutorial/blob/ros1/urdf/13-diffdrive.urdf.xacro): `urdf/13-diffdrive.urdf.xacro`

### Other components

- **ROS user**
- **Gazebo simulator**

## Connections

- ROS user → Gazebo launch: starts
- ROS user → Joint launch: starts
- ROS user → Head launch: starts
- ROS user → Gripper launch: starts
- ROS user → Drive launch: starts
