# nmt-wildlife-monitoring-project/wall-e architecture

> Architecture diagram of the GitHub repository nmt-wildlife-monitoring-project/wall-e, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nmt-wildlife-monitoring-project/wall-e
- Repository: https://github.com/nmt-wildlife-monitoring-project/wall-e

## Overview

WALL-E is a wildlife-monitoring robot system with ROS 2 drivers, GPS waypoint navigation, and a browser control panel. The principal workflow is sensor and motor bringup, localization and waypoint navigation, then operator monitoring or teleoperation through the web UI. The README documents the system-level launch capabilities; sampled source confirms parts of the LiDAR and web paths. Several ROS package internals were not sampled, so subsystem links are limited to documented relationships.

Main entry points: [`web_app/frontend/src/App.tsx`](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/App.tsx) (Dashboard UI), [`ros2_ws/src/robot_bringup/launch/robot_launch.py`](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_bringup/launch/robot_launch.py) (Robot bringup), [`web_app/frontend/src/services/rosbridge.ts`](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/services/rosbridge.ts) (Frontend ROS client), [`web_app/backend/main.py`](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/main.py) (Web API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Sensing"]
  node_bringup["Robot bringup<br/>[robot_launch.py]"]
  node_imu["IMU driver<br/>[bno085_node.py]"]
  node_gps["GPS driver"]
  node_lidar["LiDAR driver<br/>[sllidar_node.cpp]"]
  node_lidar_sdk["LiDAR SDK"]
  node_scan_unpack["Scan decoding"]
end

subgraph group_motion["Motion Control"]
  node_motors["RoboClaw driver<br/>[roboclaw_node.py]"]
end

subgraph group_navigation["Navigation"]
  node_nav_launch["Navigation launch"]
  node_localization["GPS localization"]
  node_waypoint_follower["Waypoint follower"]
  node_gps_waypoint["GPS waypoint handler"]
  node_scan_matcher["Scan matcher"]
end

subgraph group_web["Web Control"]
  node_web_ui["Dashboard UI<br/>[App.tsx]"]
  node_joystick["Joystick control"]
  node_maps["Map panels"]
  node_costmap["Costmap viewer<br/>[CostmapViewer.tsx]"]
  node_stats["Robot statistics<br/>[StatsPanel.tsx]"]
  node_camera["Camera feed<br/>[CameraFeed.tsx]"]
  node_ros_front["Frontend ROS client<br/>[rosbridge.ts]"]
  node_api["Web API<br/>[main.py]"]
  node_robot_api["Robot endpoints<br/>[robot.py]"]
  node_waypoint_api["Waypoint endpoints<br/>[waypoints.py]"]
  node_camera_api["Camera endpoint<br/>[camera.py]"]
  node_ros_backend["Backend ROS client"]
end

node_operator(("Robot operator"))
node_rosbridge["ROSBridge"]
node_ros_runtime["ROS 2 runtime"]
node_camera_device["USB camera"]

node_operator -.->|"starts sensors"| node_bringup
node_bringup -.->|"launches"| node_motors
node_bringup -.->|"launches"| node_lidar
node_bringup -.->|"launches"| node_imu
node_bringup -.->|"launches"| node_gps
node_lidar -.->|"uses SDK"| node_lidar_sdk
node_lidar_sdk -->|"decodes samples"| node_scan_unpack
node_gps -.->|"publishes fix"| node_ros_runtime
node_imu -.->|"publishes IMU"| node_ros_runtime
node_lidar -.->|"publishes scans"| node_ros_runtime
node_nav_launch -.->|"starts bringup"| node_bringup
node_nav_launch -.->|"launches EKF"| node_localization
node_nav_launch -.->|"launches follower"| node_waypoint_follower
node_nav_launch -.->|"launches Nav2"| node_ros_runtime
node_gps_waypoint -.->|"handles waypoints"| node_waypoint_follower
node_operator -->|"opens dashboard"| node_web_ui
node_web_ui -->|"renders"| node_joystick
node_web_ui -->|"renders"| node_maps
node_web_ui -->|"renders"| node_costmap
node_web_ui -->|"renders"| node_stats
node_web_ui -->|"renders"| node_camera
node_web_ui -->|"connects through"| node_ros_front
node_joystick -->|"sends velocity"| node_ros_front
node_maps -.->|"reads map data"| node_ros_front
node_costmap -->|"reads costmap"| node_ros_front
node_stats -->|"reads telemetry"| node_ros_front
node_ros_front -->|"exchanges ROS data"| node_rosbridge
node_operator -.->|"uses REST API"| node_api
node_api -->|"registers router"| node_robot_api
node_api -->|"registers router"| node_waypoint_api
node_api -->|"registers router"| node_camera_api
node_api -->|"initializes client"| node_ros_backend
node_robot_api -->|"issues robot calls"| node_ros_backend
node_ros_backend -->|"connects by WebSocket"| node_rosbridge
node_camera -.->|"requests stream"| node_camera_api
node_camera_api -.->|"streams frames"| node_camera_device

click node_bringup "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_bringup/launch/robot_launch.py"
click node_imu "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/bno085_driver/bno085_driver/bno085_node.py"
click node_gps "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/nmea_navsat_driver/src/libnmea_navsat_driver/nodes/nmea_tcpclient_driver.py"
click node_lidar "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/src/sllidar_node.cpp"
click node_lidar_sdk "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp"
click node_scan_unpack "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/sdk/src/dataunpacker/unpacker/handler_capsules.cpp"
click node_motors "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/roboclaw_driver/roboclaw_driver/roboclaw_node.py"
click node_nav_launch "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_navigation/launch/gps_waypoint_follower.launch.py"
click node_localization "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_navigation/launch/dual_ekf_navsat.launch.py"
click node_waypoint_follower "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/waypoint_server/waypoint_server/waypoint_follower_node.py"
click node_gps_waypoint "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/waypoint_server/waypoint_server/gps_waypoint_handler_node.py"
click node_scan_matcher "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/scan_matcher/scan_matcher/scan_matcher_node.py"
click node_web_ui "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/App.tsx"
click node_joystick "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/JoystickControl.tsx"
click node_maps "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/GoogleMapsPanel.tsx"
click node_costmap "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/CostmapViewer.tsx"
click node_stats "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/StatsPanel.tsx"
click node_camera "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/CameraFeed.tsx"
click node_ros_front "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/services/rosbridge.ts"
click node_api "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/main.py"
click node_robot_api "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/robot.py"
click node_waypoint_api "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/waypoints.py"
click node_camera_api "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/camera.py"
click node_ros_backend "https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/services/rosbridge_client.py"

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_bringup,node_imu,node_gps,node_lidar,node_lidar_sdk,node_scan_unpack toneBlue
class node_motors toneAmber
class node_nav_launch,node_localization,node_waypoint_follower,node_gps_waypoint,node_scan_matcher toneMint
class node_web_ui,node_joystick,node_maps,node_costmap,node_stats,node_camera,node_ros_front,node_api,node_robot_api,node_waypoint_api,node_camera_api,node_ros_backend toneRose
class node_operator,node_rosbridge,node_ros_runtime,node_camera_device toneIndigo
```

## Components

### Sensing

- [Robot bringup](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_bringup/launch/robot_launch.py): `ros2_ws/src/robot_bringup/launch/robot_launch.py`
- [IMU driver](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/bno085_driver/bno085_driver/bno085_node.py): `ros2_ws/src/bno085_driver/bno085_driver/bno085_node.py`
- [GPS driver](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/nmea_navsat_driver/src/libnmea_navsat_driver/nodes/nmea_tcpclient_driver.py): `ros2_ws/src/nmea_navsat_driver/src/libnmea_navsat_driver/nodes/nmea_tcpclient_driver.py`
- [LiDAR driver](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/src/sllidar_node.cpp): `ros2_ws/src/sllidar_ros2/src/sllidar_node.cpp`
- [LiDAR SDK](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp): `ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp`
- [Scan decoding](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/sllidar_ros2/sdk/src/dataunpacker/unpacker/handler_capsules.cpp): `ros2_ws/src/sllidar_ros2/sdk/src/dataunpacker/unpacker/handler_capsules.cpp`

### Motion Control

- [RoboClaw driver](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/roboclaw_driver/roboclaw_driver/roboclaw_node.py): `ros2_ws/src/roboclaw_driver/roboclaw_driver/roboclaw_node.py`

### Navigation

- [Navigation launch](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_navigation/launch/gps_waypoint_follower.launch.py): `ros2_ws/src/robot_navigation/launch/gps_waypoint_follower.launch.py`
- [GPS localization](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/robot_navigation/launch/dual_ekf_navsat.launch.py): `ros2_ws/src/robot_navigation/launch/dual_ekf_navsat.launch.py`
- [Waypoint follower](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/waypoint_server/waypoint_server/waypoint_follower_node.py): `ros2_ws/src/waypoint_server/waypoint_server/waypoint_follower_node.py`
- [GPS waypoint handler](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/waypoint_server/waypoint_server/gps_waypoint_handler_node.py): `ros2_ws/src/waypoint_server/waypoint_server/gps_waypoint_handler_node.py`
- [Scan matcher](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/ros2_ws/src/scan_matcher/scan_matcher/scan_matcher_node.py): `ros2_ws/src/scan_matcher/scan_matcher/scan_matcher_node.py`

### Web Control

- [Dashboard UI](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/App.tsx): `web_app/frontend/src/App.tsx`
- [Joystick control](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/JoystickControl.tsx): `web_app/frontend/src/components/JoystickControl.tsx`
- [Map panels](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/GoogleMapsPanel.tsx): `web_app/frontend/src/components/GoogleMapsPanel.tsx`
- [Costmap viewer](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/CostmapViewer.tsx): `web_app/frontend/src/components/CostmapViewer.tsx`
- [Robot statistics](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/StatsPanel.tsx): `web_app/frontend/src/components/StatsPanel.tsx`
- [Camera feed](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/components/CameraFeed.tsx): `web_app/frontend/src/components/CameraFeed.tsx`
- [Frontend ROS client](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/frontend/src/services/rosbridge.ts): `web_app/frontend/src/services/rosbridge.ts`
- [Web API](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/main.py): `web_app/backend/main.py`
- [Robot endpoints](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/robot.py): `web_app/backend/routers/robot.py`
- [Waypoint endpoints](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/waypoints.py): `web_app/backend/routers/waypoints.py`
- [Camera endpoint](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/routers/camera.py): `web_app/backend/routers/camera.py`
- [Backend ROS client](https://github.com/nmt-wildlife-monitoring-project/wall-e/blob/main/web_app/backend/services/rosbridge_client.py): `web_app/backend/services/rosbridge_client.py`

### Other components

- **Robot operator**
- **ROSBridge**
- **ROS 2 runtime**
- **USB camera**

## Connections

- Robot operator → Robot bringup: starts sensors (evidence: `README.md`)
- Robot bringup → RoboClaw driver: launches (evidence: `README.md`)
- Robot bringup → LiDAR driver: launches (evidence: `README.md`)
- Robot bringup → IMU driver: launches (evidence: `README.md`)
- Robot bringup → GPS driver: launches (evidence: `README.md`)
- LiDAR driver → LiDAR SDK: uses SDK
- LiDAR SDK → Scan decoding: decodes samples (evidence: `ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp`)
- GPS driver → ROS 2 runtime: publishes fix (evidence: `README.md`)
- IMU driver → ROS 2 runtime: publishes IMU (evidence: `README.md`)
- LiDAR driver → ROS 2 runtime: publishes scans (evidence: `README.md`)
- Navigation launch → Robot bringup: starts bringup (evidence: `README.md`)
- Navigation launch → GPS localization: launches EKF (evidence: `README.md`)
- Navigation launch → Waypoint follower: launches follower (evidence: `README.md`)
- Navigation launch → ROS 2 runtime: launches Nav2 (evidence: `README.md`)
- GPS waypoint handler → Waypoint follower: handles waypoints
- Robot operator → Dashboard UI: opens dashboard (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Joystick control: renders (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Map panels: renders (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Costmap viewer: renders (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Robot statistics: renders (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Camera feed: renders (evidence: `web_app/frontend/src/App.tsx`)
- Dashboard UI → Frontend ROS client: connects through (evidence: `web_app/frontend/src/App.tsx`)
- Joystick control → Frontend ROS client: sends velocity (evidence: `web_app/frontend/src/components/JoystickControl.tsx`)
- Map panels → Frontend ROS client: reads map data (evidence: `web_app/frontend/src/components/GoogleMapsPanel.tsx`)
- Costmap viewer → Frontend ROS client: reads costmap (evidence: `web_app/frontend/src/components/CostmapViewer.tsx`)
- Robot statistics → Frontend ROS client: reads telemetry (evidence: `web_app/frontend/src/components/StatsPanel.tsx`)
- Frontend ROS client → ROSBridge: exchanges ROS data (evidence: `web_app/frontend/src/services/rosbridge.ts`)
- Robot operator → Web API: uses REST API
- Web API → Robot endpoints: registers router (evidence: `web_app/backend/main.py`)
- Web API → Waypoint endpoints: registers router (evidence: `web_app/backend/main.py`)
- Web API → Camera endpoint: registers router (evidence: `web_app/backend/main.py`)
- Web API → Backend ROS client: initializes client (evidence: `web_app/backend/main.py`)
- Robot endpoints → Backend ROS client: issues robot calls (evidence: `web_app/backend/routers/robot.py`)
- Backend ROS client → ROSBridge: connects by WebSocket (evidence: `web_app/backend/services/rosbridge_client.py`)
- Camera feed → Camera endpoint: requests stream
- Camera endpoint → USB camera: streams frames
