How aungkaung1928/tf-transform-explorer works
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: tf_explorer.launch.py System launch · nav2_params.yaml Nav2 navigation · tf_anomaly_detector.cpp TF anomaly detector · gz_bridge.yaml Topic bridge
Components 23
Simulation
- System launch
launch/tf_explorer.launch.py - Gazebo world
worlds/explorer_world.sdf - Burger model
description/turtlebot3_burger.urdf.xacro - Robot state publisher
launch/tf_explorer.launch.py - Topic bridge
config/gz_bridge.yaml
Mapping and navigation
- SLAM toolbox
config/slam_params.yaml - Nav2 navigation
config/nav2_params.yaml - Autonomous patrol
src/patrol_node.cpp - Wiggle recovery
src/simple_wiggle_recovery.cpp
Transform tools
- TF monitor
src/tf_monitor_node.cpp - Frame broadcaster
src/frame_broadcaster_node.cpp - TF anomaly detector
src/tf_anomaly_detector.cpp - TF diagnostics message
msg/TFDiagnostics.msg - RViz visualization
rviz/tf_explorer.rviz
Navigation extension
- Keepout layer
src/keepout_layer.cpp - Plugin registration
costmap_plugins.xml
Other components
- Operator
- Gazebo Harmonic
- ROS TF transforms
- Navigation goals
- Velocity commands
- Pose history
- Diagnostics topic
Connections 29
- Operator → System launch: starts
README.md - System launch → Gazebo Harmonic: launches
launch/tf_explorer.launch.py - System launch → Gazebo world: loads
launch/tf_explorer.launch.py - System launch → Burger model: uses xacro
launch/tf_explorer.launch.py - System launch → Robot state publisher: starts
launch/tf_explorer.launch.py - System launch → Topic bridge: configures
launch/tf_explorer.launch.py - System launch → SLAM toolbox: starts
launch/tf_explorer.launch.py - System launch → Nav2 navigation: starts
launch/tf_explorer.launch.py - System launch → Autonomous patrol: starts
launch/tf_explorer.launch.py - System launch → TF monitor: starts
launch/tf_explorer.launch.py - System launch → Frame broadcaster: starts
launch/tf_explorer.launch.py - System launch → TF anomaly detector: starts
launch/tf_explorer.launch.py - System launch → RViz visualization: starts
launch/tf_explorer.launch.py - Topic bridge → Gazebo Harmonic: bridges topics
README.md - Autonomous patrol → Navigation goals: sends goals
README.md - Navigation goals → Nav2 navigation: dispatches goals
README.md - Nav2 navigation → Velocity commands: publishes velocity
README.md - Velocity commands → Topic bridge: bridges commands
README.md - SLAM toolbox → Nav2 navigation: provides mapping
README.md - Nav2 navigation → Keepout layer: loads layer
README.md - Plugin registration → Keepout layer: registers plugin
README.md - Robot state publisher → ROS TF transforms: publishes frames
README.md - Frame broadcaster → ROS TF transforms: broadcasts frames
src/frame_broadcaster_node.cpp - ROS TF transforms → TF monitor: provides transforms
src/tf_monitor_node.cpp - ROS TF transforms → TF anomaly detector: provides transforms
src/tf_anomaly_detector.cpp - TF anomaly detector → TF diagnostics message: publishes
src/tf_anomaly_detector.cpp - TF anomaly detector → Diagnostics topic: publishes health
src/tf_anomaly_detector.cpp - TF monitor → Pose history: publishes poses
src/tf_monitor_node.cpp - Wiggle recovery → Velocity commands: publishes motion
src/simple_wiggle_recovery.cpp