# manifoldtechltd/odin-nav-stack2 architecture

> Architecture diagram of the GitHub repository manifoldtechltd/odin-nav-stack2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manifoldtechltd/odin-nav-stack2
- Repository: https://github.com/manifoldtechltd/odin-nav-stack2

## Overview

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/neupan/ros/neupan_ros.py`](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/ros/neupan_ros.py) (NeuPAN ROS), [`sru/src/navigation_policy_node.py`](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/sru/src/navigation_policy_node.py) (SRU Policy), [`web_console/server.py`](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/web_console/server.py) (Web Console), [`ros2_ws/src/mission_manager/src/mission_manager_node.cpp`](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/mission_manager/src/mission_manager_node.cpp) (ROS 2 Missions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mission["Mission and Operations"]
  node_console["Web Console<br/>[server.py]"]
  node_mission2["ROS 2 Missions"]
  node_mission1["ROS 1 Missions"]
  node_atomic["Atomic Motion"]
end

subgraph group_navigation["Route and Mapping"]
  node_planner2["ROS 2 A* Planner<br/>[map_planner.cpp]"]
  node_planner1["ROS 1 A* Planner<br/>[map_planner.cpp]"]
  node_sliding["Sliding Map<br/>[sliding_map.cpp]"]
end

subgraph group_policy["Local Planning"]
  node_neupanros["NeuPAN ROS<br/>[neupan_ros.py]"]
  node_neupan["NeuPAN Core<br/>[neupan.py]"]
  node_blocks["Planner Blocks"]
  node_robotmodel["Robot Model<br/>[robot.py]"]
  node_sru["SRU Policy"]
  node_sru2["ROS 2 SRU Adapter"]
  node_sru1["ROS 1 SRU Adapter"]
end

subgraph group_platform["Robot Interfaces"]
  node_sw01["SW01 Control<br/>[sw01_bridge.cpp]"]
  node_unitree["Unitree Control"]
  node_dobot["Dobot Control<br/>[dobot_bridge.cpp]"]
end

subgraph group_perception["Perception and Monitoring"]
  node_odin["Odin1 Sensors"]
  node_vlm["VLM Terminal"]
  node_monitor["Remote Monitor<br/>[remote_monitor.py]"]
end

node_operator(("Operator"))

node_operator -->|"controls"| node_console
node_console -.->|"dispatches missions"| node_mission2
node_console -.->|"dispatches missions"| node_mission1
node_console -.->|"enables teleop"| node_sw01
node_console -.->|"requests monitoring"| node_monitor
node_mission2 -.->|"requests routes"| node_planner2
node_mission1 -.->|"requests routes"| node_planner1
node_planner2 -->|"uses obstacle memory"| node_sliding
node_planner1 -->|"uses obstacle memory"| node_sliding
node_planner2 -->|"provides global path"| node_neupanros
node_planner1 -->|"provides global path"| node_neupanros
node_neupanros -->|"calls planner core"| node_neupan
node_neupan -->|"uses planning blocks"| node_blocks
node_neupan -->|"uses robot model"| node_robotmodel
node_neupanros -.->|"publishes motion commands"| node_sw01
node_neupanros -.->|"publishes motion commands"| node_unitree
node_neupanros -.->|"publishes motion commands"| node_dobot
node_mission2 -.->|"requests alignment"| node_atomic
node_mission1 -.->|"requests alignment"| node_atomic
node_odin -.->|"supplies sensor data"| node_sliding
node_odin -->|"supplies depth images"| node_sru
node_sru2 -.->|"runs policy"| node_sru
node_sru1 -.->|"runs policy"| node_sru
node_sru -.->|"routes velocity"| node_sw01
node_sru -.->|"routes velocity"| node_unitree
node_sru -.->|"routes velocity"| node_dobot
node_odin -.->|"provides scene input"| node_vlm
node_vlm -.->|"reports scene findings"| node_operator

click node_console "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/web_console/server.py"
click node_mission2 "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/mission_manager/src/mission_manager_node.cpp"
click node_mission1 "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/mission_manager/src/mission_manager_node.cpp"
click node_atomic "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/atomic_move/src/atomic_move_node.cpp"
click node_planner2 "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/map_planner/src/map_planner.cpp"
click node_planner1 "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/map_planner/src/map_planner.cpp"
click node_sliding "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/sliding_map/src/sliding_map.cpp"
click node_neupanros "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/ros/neupan_ros.py"
click node_neupan "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/neupan.py"
click node_blocks "https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/NeuPAN/neupan/blocks"
click node_robotmodel "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/robot/robot.py"
click node_sru "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/sru/src/navigation_policy_node.py"
click node_sru2 "https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/ros2_ws/src/sru_nav"
click node_sru1 "https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/ros_ws/src/sru_nav"
click node_sw01 "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/sw01_ros_control/src/sw01_bridge.cpp"
click node_unitree "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/unitree_control/src/unitree_vel_controller.cpp"
click node_dobot "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/dobot_ros_control/src/dobot_bridge.cpp"
click node_vlm "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/odin_vlm_terminal/scripts/ros_vlm_terminal.py"
click node_monitor "https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/scripts/remote_monitor.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_console,node_mission2,node_mission1,node_atomic toneBlue
class node_planner2,node_planner1,node_sliding toneAmber
class node_neupanros,node_neupan,node_blocks,node_robotmodel,node_sru,node_sru2,node_sru1 toneMint
class node_sw01,node_unitree,node_dobot toneRose
class node_odin,node_vlm,node_monitor,node_operator toneIndigo
```

## Components

### Mission and Operations

- [Web Console](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/web_console/server.py): `web_console/server.py`
- [ROS 2 Missions](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/mission_manager/src/mission_manager_node.cpp): `ros2_ws/src/mission_manager/src/mission_manager_node.cpp`
- [ROS 1 Missions](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/mission_manager/src/mission_manager_node.cpp): `ros_ws/src/mission_manager/src/mission_manager_node.cpp`
- [Atomic Motion](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/atomic_move/src/atomic_move_node.cpp): `ros2_ws/src/atomic_move/src/atomic_move_node.cpp`

### Route and Mapping

- [ROS 2 A* Planner](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/map_planner/src/map_planner.cpp): `ros2_ws/src/map_planner/src/map_planner.cpp`
- [ROS 1 A* Planner](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/map_planner/src/map_planner.cpp): `ros_ws/src/map_planner/src/map_planner.cpp`
- [Sliding Map](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/sliding_map/src/sliding_map.cpp): `ros2_ws/src/sliding_map/src/sliding_map.cpp`

### Local Planning

- [NeuPAN ROS](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/ros/neupan_ros.py): `NeuPAN/neupan/ros/neupan_ros.py`
- [NeuPAN Core](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/neupan.py): `NeuPAN/neupan/neupan.py`
- [Planner Blocks](https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/NeuPAN/neupan/blocks): `NeuPAN/neupan/blocks`
- [Robot Model](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/NeuPAN/neupan/robot/robot.py): `NeuPAN/neupan/robot/robot.py`
- [SRU Policy](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/sru/src/navigation_policy_node.py): `sru/src/navigation_policy_node.py`
- [ROS 2 SRU Adapter](https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/ros2_ws/src/sru_nav): `ros2_ws/src/sru_nav`
- [ROS 1 SRU Adapter](https://github.com/manifoldtechltd/odin-nav-stack2/tree/main/ros_ws/src/sru_nav): `ros_ws/src/sru_nav`

### Robot Interfaces

- [SW01 Control](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/sw01_ros_control/src/sw01_bridge.cpp): `ros2_ws/src/sw01_ros_control/src/sw01_bridge.cpp`
- [Unitree Control](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/unitree_control/src/unitree_vel_controller.cpp): `ros_ws/src/unitree_control/src/unitree_vel_controller.cpp`
- [Dobot Control](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros_ws/src/dobot_ros_control/src/dobot_bridge.cpp): `ros_ws/src/dobot_ros_control/src/dobot_bridge.cpp`

### Perception and Monitoring

- **Odin1 Sensors**
- [VLM Terminal](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/src/odin_vlm_terminal/scripts/ros_vlm_terminal.py): `ros2_ws/src/odin_vlm_terminal/scripts/ros_vlm_terminal.py`
- [Remote Monitor](https://github.com/manifoldtechltd/odin-nav-stack2/blob/main/ros2_ws/scripts/remote_monitor.py): `ros2_ws/scripts/remote_monitor.py`

### Other components

- **Operator**

## Connections

- 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 (evidence: `NeuPAN/neupan/ros/neupan_ros.py`)
- NeuPAN Core → Planner Blocks: uses planning blocks (evidence: `NeuPAN/neupan/neupan.py`)
- NeuPAN Core → Robot Model: uses robot model (evidence: `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
