How manifoldtechltd/odin-nav-stack2 works
ONS2 is a dual-ROS autonomous patrol stack: missions and operator commands drive global route planning and a selectable local policy, whose motion commands reach a robot-specific control interface. The README documents the main navigation and mission capabilities; sampled source confirms selected NeuPAN, mission-manager, and console interactions. Several important packages are represented from the README and tree rather than inspected implementation, so their internal links are limited to documented relationships.
Main entry points: neupan_ros.py NeuPAN ROS · navigation_policy_node.py SRU Policy · server.py Web Console · mission_manager_node.cpp ROS 2 Missions
Components 21
Mission and Operations
- Web Console
web_console/server.py - ROS 2 Missions
ros2_ws/src/mission_manager/src/mission_manager_node.cpp - ROS 1 Missions
ros_ws/src/mission_manager/src/mission_manager_node.cpp - Atomic Motion
ros2_ws/src/atomic_move/src/atomic_move_node.cpp
Route and Mapping
- ROS 2 A* Planner
ros2_ws/src/map_planner/src/map_planner.cpp - ROS 1 A* Planner
ros_ws/src/map_planner/src/map_planner.cpp - Sliding Map
ros2_ws/src/sliding_map/src/sliding_map.cpp
Local Planning
- NeuPAN ROS
NeuPAN/neupan/ros/neupan_ros.py - NeuPAN Core
NeuPAN/neupan/neupan.py - Planner Blocks
NeuPAN/neupan/blocks - Robot Model
NeuPAN/neupan/robot/robot.py - SRU Policy
sru/src/navigation_policy_node.py - ROS 2 SRU Adapter
ros2_ws/src/sru_nav - ROS 1 SRU Adapter
ros_ws/src/sru_nav
Robot Interfaces
- SW01 Control
ros2_ws/src/sw01_ros_control/src/sw01_bridge.cpp - Unitree Control
ros_ws/src/unitree_control/src/unitree_vel_controller.cpp - Dobot Control
ros_ws/src/dobot_ros_control/src/dobot_bridge.cpp
Perception and Monitoring
- Odin1 Sensors
- VLM Terminal
ros2_ws/src/odin_vlm_terminal/scripts/ros_vlm_terminal.py - Remote Monitor
ros2_ws/scripts/remote_monitor.py
Other components
- Operator
Connections 28
- Operator → Web Console: controls
- Web Console → ROS 2 Missions: dispatches missions
- Web Console → ROS 1 Missions: dispatches missions
- Web Console → SW01 Control: enables teleop
- Web Console → Remote Monitor: requests monitoring
- ROS 2 Missions → ROS 2 A* Planner: requests routes
- ROS 1 Missions → ROS 1 A* Planner: requests routes
- ROS 2 A* Planner → Sliding Map: uses obstacle memory
- ROS 1 A* Planner → Sliding Map: uses obstacle memory
- ROS 2 A* Planner → NeuPAN ROS: provides global path
- ROS 1 A* Planner → NeuPAN ROS: provides global path
- NeuPAN ROS → NeuPAN Core: calls planner core
NeuPAN/neupan/ros/neupan_ros.py - NeuPAN Core → Planner Blocks: uses planning blocks
NeuPAN/neupan/neupan.py - NeuPAN Core → Robot Model: uses robot model
NeuPAN/neupan/neupan.py - NeuPAN ROS → SW01 Control: publishes motion commands
- NeuPAN ROS → Unitree Control: publishes motion commands
- NeuPAN ROS → Dobot Control: publishes motion commands
- ROS 2 Missions → Atomic Motion: requests alignment
- ROS 1 Missions → Atomic Motion: requests alignment
- Odin1 Sensors → Sliding Map: supplies sensor data
- Odin1 Sensors → SRU Policy: supplies depth images
- ROS 2 SRU Adapter → SRU Policy: runs policy
- ROS 1 SRU Adapter → SRU Policy: runs policy
- SRU Policy → SW01 Control: routes velocity
- SRU Policy → Unitree Control: routes velocity
- SRU Policy → Dobot Control: routes velocity
- Odin1 Sensors → VLM Terminal: provides scene input
- VLM Terminal → Operator: reports scene findings