# aungkaung1928/tf-transform-explorer architecture

> Architecture diagram of the GitHub repository aungkaung1928/tf-transform-explorer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aungkaung1928/tf-transform-explorer
- Repository: https://github.com/aungkaung1928/tf-transform-explorer

## Overview

TF Transform Explorer is a ROS 2 TurtleBot3 simulation and autonomous-exploration demo. The launch file starts Gazebo, robot-state publishing, the ROS–Gazebo bridge, SLAM, Nav2, custom TF nodes, patrol, and RViz; patrol sends navigation goals, while the bridge carries simulation topics. Separate branches provide transform monitoring, frame broadcasting, anomaly diagnostics, and a keepout costmap plugin. The launch and sampled C++ establish several connections; README statements support the documented SLAM/Nav2 and plugin integrations. Unshown wiring is omitted rather than inferred.

Main entry points: [`launch/tf_explorer.launch.py`](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/launch/tf_explorer.launch.py) (System launch), [`config/nav2_params.yaml`](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/nav2_params.yaml) (Nav2 navigation), [`src/tf_anomaly_detector.cpp`](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/tf_anomaly_detector.cpp) (TF anomaly detector), [`config/gz_bridge.yaml`](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/gz_bridge.yaml) (Topic bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sim["Simulation"]
  node_launch["System launch"]
  node_world["Gazebo world<br/>[explorer_world.sdf]"]
  node_robot["Burger model"]
  node_state["Robot state publisher"]
  node_bridge["Topic bridge<br/>[gz_bridge.yaml]"]
end

subgraph group_nav["Mapping and navigation"]
  node_slam["SLAM toolbox<br/>[slam_params.yaml]"]
  node_nav2["Nav2 navigation<br/>[nav2_params.yaml]"]
  node_patrol["Autonomous patrol<br/>[patrol_node.cpp]"]
  node_recovery["Wiggle recovery"]
end

subgraph group_tf["Transform tools"]
  node_tf_monitor["TF monitor"]
  node_broadcaster["Frame broadcaster"]
  node_anomaly["TF anomaly detector"]
  node_diagnostics["TF diagnostics message<br/>[TFDiagnostics.msg]"]
  node_rviz["RViz visualization<br/>[tf_explorer.rviz]"]
end

subgraph group_plugin["Navigation extension"]
  node_keepout["Keepout layer<br/>[keepout_layer.cpp]"]
  node_plugin_registry["Plugin registration"]
end

node_operator(("Operator"))
node_simulator["Gazebo Harmonic"]
node_tf_bus["ROS TF transforms"]
node_nav_goals["Navigation goals"]
node_cmd_vel["Velocity commands"]
node_pose_history["Pose history"]
node_tf_diagnostics_topic["Diagnostics topic"]

node_operator -->|"starts"| node_launch
node_launch -->|"launches"| node_simulator
node_launch -->|"loads"| node_world
node_launch -->|"uses xacro"| node_robot
node_launch -->|"starts"| node_state
node_launch -->|"configures"| node_bridge
node_launch -->|"starts"| node_slam
node_launch -->|"starts"| node_nav2
node_launch -->|"starts"| node_patrol
node_launch -->|"starts"| node_tf_monitor
node_launch -->|"starts"| node_broadcaster
node_launch -->|"starts"| node_anomaly
node_launch -->|"starts"| node_rviz
node_bridge -->|"bridges topics"| node_simulator
node_patrol -->|"sends goals"| node_nav_goals
node_nav_goals -->|"dispatches goals"| node_nav2
node_nav2 -->|"publishes velocity"| node_cmd_vel
node_cmd_vel -->|"bridges commands"| node_bridge
node_slam -.->|"provides mapping"| node_nav2
node_nav2 -->|"loads layer"| node_keepout
node_plugin_registry -->|"registers plugin"| node_keepout
node_state -.->|"publishes frames"| node_tf_bus
node_broadcaster -->|"broadcasts frames"| node_tf_bus
node_tf_bus -->|"provides transforms"| node_tf_monitor
node_tf_bus -->|"provides transforms"| node_anomaly
node_anomaly -->|"publishes"| node_diagnostics
node_anomaly -->|"publishes health"| node_tf_diagnostics_topic
node_tf_monitor -->|"publishes poses"| node_pose_history
node_recovery -->|"publishes motion"| node_cmd_vel

click node_launch "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/launch/tf_explorer.launch.py"
click node_world "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/worlds/explorer_world.sdf"
click node_robot "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/description/turtlebot3_burger.urdf.xacro"
click node_state "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/launch/tf_explorer.launch.py"
click node_bridge "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/gz_bridge.yaml"
click node_slam "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/slam_params.yaml"
click node_nav2 "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/nav2_params.yaml"
click node_patrol "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/patrol_node.cpp"
click node_recovery "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/simple_wiggle_recovery.cpp"
click node_keepout "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/keepout_layer.cpp"
click node_plugin_registry "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/costmap_plugins.xml"
click node_tf_monitor "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/tf_monitor_node.cpp"
click node_broadcaster "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/frame_broadcaster_node.cpp"
click node_anomaly "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/tf_anomaly_detector.cpp"
click node_diagnostics "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/msg/TFDiagnostics.msg"
click node_rviz "https://github.com/aungkaung1928/tf-transform-explorer/blob/main/rviz/tf_explorer.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_launch,node_world,node_robot,node_state,node_bridge toneBlue
class node_slam,node_nav2,node_patrol,node_recovery toneAmber
class node_tf_monitor,node_broadcaster,node_anomaly,node_diagnostics,node_rviz toneMint
class node_keepout,node_plugin_registry toneRose
class node_operator,node_simulator,node_tf_bus,node_nav_goals,node_cmd_vel,node_pose_history,node_tf_diagnostics_topic toneIndigo
```

## Components

### Simulation

- [System launch](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/launch/tf_explorer.launch.py): `launch/tf_explorer.launch.py`
- [Gazebo world](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/worlds/explorer_world.sdf): `worlds/explorer_world.sdf`
- [Burger model](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/description/turtlebot3_burger.urdf.xacro): `description/turtlebot3_burger.urdf.xacro`
- [Robot state publisher](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/launch/tf_explorer.launch.py): `launch/tf_explorer.launch.py`
- [Topic bridge](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/gz_bridge.yaml): `config/gz_bridge.yaml`

### Mapping and navigation

- [SLAM toolbox](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/slam_params.yaml): `config/slam_params.yaml`
- [Nav2 navigation](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/config/nav2_params.yaml): `config/nav2_params.yaml`
- [Autonomous patrol](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/patrol_node.cpp): `src/patrol_node.cpp`
- [Wiggle recovery](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/simple_wiggle_recovery.cpp): `src/simple_wiggle_recovery.cpp`

### Transform tools

- [TF monitor](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/tf_monitor_node.cpp): `src/tf_monitor_node.cpp`
- [Frame broadcaster](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/frame_broadcaster_node.cpp): `src/frame_broadcaster_node.cpp`
- [TF anomaly detector](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/tf_anomaly_detector.cpp): `src/tf_anomaly_detector.cpp`
- [TF diagnostics message](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/msg/TFDiagnostics.msg): `msg/TFDiagnostics.msg`
- [RViz visualization](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/rviz/tf_explorer.rviz): `rviz/tf_explorer.rviz`

### Navigation extension

- [Keepout layer](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/src/keepout_layer.cpp): `src/keepout_layer.cpp`
- [Plugin registration](https://github.com/aungkaung1928/tf-transform-explorer/blob/main/costmap_plugins.xml): `costmap_plugins.xml`

### Other components

- **Operator**
- **Gazebo Harmonic**
- **ROS TF transforms**
- **Navigation goals**
- **Velocity commands**
- **Pose history**
- **Diagnostics topic**

## Connections

- Operator → System launch: starts (evidence: `README.md`)
- System launch → Gazebo Harmonic: launches (evidence: `launch/tf_explorer.launch.py`)
- System launch → Gazebo world: loads (evidence: `launch/tf_explorer.launch.py`)
- System launch → Burger model: uses xacro (evidence: `launch/tf_explorer.launch.py`)
- System launch → Robot state publisher: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → Topic bridge: configures (evidence: `launch/tf_explorer.launch.py`)
- System launch → SLAM toolbox: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → Nav2 navigation: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → Autonomous patrol: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → TF monitor: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → Frame broadcaster: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → TF anomaly detector: starts (evidence: `launch/tf_explorer.launch.py`)
- System launch → RViz visualization: starts (evidence: `launch/tf_explorer.launch.py`)
- Topic bridge → Gazebo Harmonic: bridges topics (evidence: `README.md`)
- Autonomous patrol → Navigation goals: sends goals (evidence: `README.md`)
- Navigation goals → Nav2 navigation: dispatches goals (evidence: `README.md`)
- Nav2 navigation → Velocity commands: publishes velocity (evidence: `README.md`)
- Velocity commands → Topic bridge: bridges commands (evidence: `README.md`)
- SLAM toolbox → Nav2 navigation: provides mapping (evidence: `README.md`)
- Nav2 navigation → Keepout layer: loads layer (evidence: `README.md`)
- Plugin registration → Keepout layer: registers plugin (evidence: `README.md`)
- Robot state publisher → ROS TF transforms: publishes frames (evidence: `README.md`)
- Frame broadcaster → ROS TF transforms: broadcasts frames (evidence: `src/frame_broadcaster_node.cpp`)
- ROS TF transforms → TF monitor: provides transforms (evidence: `src/tf_monitor_node.cpp`)
- ROS TF transforms → TF anomaly detector: provides transforms (evidence: `src/tf_anomaly_detector.cpp`)
- TF anomaly detector → TF diagnostics message: publishes (evidence: `src/tf_anomaly_detector.cpp`)
- TF anomaly detector → Diagnostics topic: publishes health (evidence: `src/tf_anomaly_detector.cpp`)
- TF monitor → Pose history: publishes poses (evidence: `src/tf_monitor_node.cpp`)
- Wiggle recovery → Velocity commands: publishes motion (evidence: `src/simple_wiggle_recovery.cpp`)
