How vandanarora18/edge-avoidance-bot works
This ROS 2 workspace simulates a differential-drive robot and documents an autonomous edge-avoidance behavior: launch the simulated robot, provide LiDAR scans, detect a cliff, and command recovery motion through the drive controller. The principal packages cover robot modeling, simulation and sensor bridging, controller setup, and the Python behavior node. The launch excerpt comments out the edge-avoidance node, so the documented behavior is not active in that launch as shown. Model, world, RViz, and controller internals were not sampled; their paths and roles are based on the README and file tree.
Main entry points: gazebo.launch.py Gazebo Launch · simulated_robot.launch.py Simulation Launch · controller.launch.py Controller Launch · edge_detection.py Edge Avoidance Node
Components 18
Simulation Orchestration
- Simulation Launch
src/bot_bringup/launch/simulated_robot.launch.py - Gazebo Launch
src/bot_description/launch/gazebo.launch.py - Gazebo Simulation
- Robot Spawner
- ROS-Gazebo Bridge
- RViz Display
src/bot_description/launch/display.launch.py
Robot Model
- Robot Model
src/bot_description/urdf - Gazebo Worlds
src/bot_description/worlds - State Publisher
- LiDAR Scan
Motion Control
- Controller Launch
src/bot_controller/launch/controller.launch.py - Controller Config
src/bot_controller/config - Controller Manager
- Differential Drive
Edge Avoidance
- Edge Avoidance Node
src/bot_script/bot_script/edge_detection.py - /scan
- Velocity Commands
Other components
- Operator
Connections 19
- Operator → Simulation Launch: launches
README.md - Simulation Launch → Gazebo Launch: includes
src/bot_bringup/launch/simulated_robot.launch.py - Simulation Launch → Controller Launch: includes
src/bot_bringup/launch/simulated_robot.launch.py - Simulation Launch → RViz Display: starts
src/bot_bringup/launch/simulated_robot.launch.py - Gazebo Launch → Robot Model: loads
src/bot_description/launch/gazebo.launch.py - Gazebo Launch → Gazebo Worlds: selects
src/bot_description/launch/gazebo.launch.py - Gazebo Launch → State Publisher: starts
src/bot_description/launch/gazebo.launch.py - Gazebo Launch → Gazebo Simulation: starts
src/bot_description/launch/gazebo.launch.py - Gazebo Launch → Robot Spawner: starts
src/bot_description/launch/gazebo.launch.py - Gazebo Launch → ROS-Gazebo Bridge: starts
src/bot_description/launch/gazebo.launch.py - Robot Spawner → State Publisher: reads description
- ROS-Gazebo Bridge → /scan: bridges scan
- LiDAR Scan → ROS-Gazebo Bridge: publishes scan
- Controller Launch → Controller Manager: spawns controllers
src/bot_controller/launch/controller.launch.py - Controller Config → Differential Drive: configures
- /scan → Edge Avoidance Node: feeds scans
src/bot_script/bot_script/edge_detection.py - Edge Avoidance Node → Velocity Commands: publishes commands
src/bot_script/bot_script/edge_detection.py - Velocity Commands → Differential Drive: commands motion
- Differential Drive → Gazebo Simulation: drives robot