How sh33p-cell/eyrc works
Hola The Explorer is a ROS 2 robotics project spanning MuJoCo simulation and staged holonomic-robot tasks. The software workflow runs a simulation and camera, detects arena features and converts image coordinates to world coordinates, then controls robots through shape-tracing or multi-robot navigation and planning. The graph emphasizes the sampled ROS nodes and their documented topic/service interfaces; later collaboration challenges described in the README are not represented by sampled implementation paths, so their internal flow is not inferred.
Main entry points: launch Task launches · camera_detection.py Checkpoint vision · sim_control.py Shape controller · bin Camera stream
Components 17
Simulation and cameras
- Task launches
Software/workspace/src/hb_description/launch - MuJoCo bridge
Software/workspace/src/hb_description/bin - Camera stream
Software/workspace/src/hb_description/bin
Perception and interfaces
- Checkpoint vision
Software/workspace/src/task_1a/task_1a/camera_detection.py - Pixel mapping
Software/workspace/src/task_1a - Shape interfaces
Software/workspace/src/shape_interface
Robot control
- Inverse kinematics
Software/workspace/src/task_1b/task_1b/inverse_kinematics.py - Velocity publisher
Software/workspace/src/task_1b - Shape controller
Software/workspace/src/task_1c/task_1c/sim_control.py - Shape service
Software/workspace/src/task_1c/bin
Navigation and planning
- Multi-robot follower
Software/workspace/src/task_2a/task_2a/path_follower.py - Obstacle planner
Software/workspace/src/task_2b/task_2b/path_planner.py - Planned-path follower
Software/workspace/src/task_2b/task_2b/path_follower.py - Collision planner
Software/workspace/src/task_2c/task_2c/path_planner.py - Coordinated follower
Software/workspace/src/task_2c/task_2c/path_follower.py
Other components
- Operator
- Robot ROS topics
Connections 15
- Operator → Task launches: starts tasks
ReadMe.md - Task launches → MuJoCo bridge: launches bridge
Software/workspace/src/hb_description/launch/task1b.launch.py - Task launches → Camera stream: launches camera
Software/workspace/src/hb_description/launch/task1b.launch.py - Camera stream → Checkpoint vision: streams frames
Software/workspace/src/task_1a/task_1a/camera_detection.py - Checkpoint vision → Pixel mapping: requests coordinates
Software/workspace/src/task_1a/task_1a/camera_detection.py - Checkpoint vision → Shape interfaces: uses pixel service
Software/workspace/src/task_1a/task_1a/camera_detection.py - Shape controller → Shape interfaces: requests shape
Software/workspace/src/task_1c/task_1c/sim_control.py - Shape controller → Shape service: calls shape service
Software/workspace/src/task_1c/task_1c/sim_control.py - Velocity publisher → Inverse kinematics: publishes velocity
Software/workspace/src/task_1b/task_1b/inverse_kinematics.py - Inverse kinematics → Robot ROS topics: publishes wheel commands
Software/workspace/src/task_1b/task_1b/inverse_kinematics.py - Multi-robot follower → Robot ROS topics: reads odometry; sends wheels
Software/workspace/src/task_2a/task_2a/path_follower.py - Obstacle planner → Robot ROS topics: reads odometry; publishes plans
Software/workspace/src/task_2b/task_2b/path_planner.py - Planned-path follower → Robot ROS topics: reads plans and odometry; sends wheels
Software/workspace/src/task_2b/task_2b/path_follower.py - Collision planner → Robot ROS topics: reads odometry; publishes plans
Software/workspace/src/task_2c/task_2c/path_planner.py - Coordinated follower → Robot ROS topics: reads plans and odometry; sends wheels
Software/workspace/src/task_2c/task_2c/path_follower.py