# xchallenge-zespol-pw/unitree_moveit2 architecture

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

- Interactive diagram: https://gitdiagram.com/xchallenge-zespol-pw/unitree_moveit2
- Repository: https://github.com/xchallenge-zespol-pw/unitree_moveit2

## Overview

This repository provides Unitree G1 arm manipulation through MoveIt 2, with an optional lidar filter that removes ball points before obstacle mapping. The main workflow is to start the robot-specific MoveIt configuration, use the manipulation interface to prepare a collision scene and request arm motions, then execute those motions through MoveIt. The interface delegates planning and execution to the arm controller and scene updates to the collision manager. The README is brief; finer capabilities come from sampled source comments and launch files, so unsampled connections are omitted.

Main entry points: [`g1_moveit/launch/move_group.launch.py`](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/launch/move_group.launch.py) (MoveIt Launch), [`obstacle_remover_node/src/obstacle_remover_node.cpp`](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/src/obstacle_remover_node.cpp) (Cloud Filter), [`unitree_arms/src/unitree_moveit_interface.cpp`](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/unitree_moveit_interface.cpp) (Manipulation Interface), [`unitree_arms/src/arm_controller.cpp`](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/arm_controller.cpp) (Arm Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["MoveIt Setup"]
  node_moveit_launch["MoveIt Launch"]
  node_robot_model["G1 Robot Model"]
  node_move_group["MoveIt Move Group"]
end

subgraph group_manipulation["Arm Manipulation"]
  node_manipulation_api["Manipulation Interface"]
  node_arm_controller["Arm Controller<br/>[arm_controller.cpp]"]
end

subgraph group_scene["Collision Scene"]
  node_collision_manager["Collision Manager"]
  node_planning_scene[("Planning Scene")]
end

subgraph group_perception["Obstacle Filtering"]
  node_obstacle_launch["Filter Launch"]
  node_obstacle_main["Filter Entry"]
  node_obstacle_filter["Cloud Filter"]
  node_octomap[("MoveIt OctoMap")]
end

node_operator(("Operator"))
node_robot_control["Robot Controllers"]
node_rviz["RViz"]
node_lidar["Lidar Cloud"]
node_tf["TF Frames"]
node_filtered_cloud["Filtered Cloud"]

node_operator -->|"starts"| node_moveit_launch
node_moveit_launch -->|"loads model"| node_robot_model
node_moveit_launch -->|"starts"| node_move_group
node_operator -.->|"requests motions"| node_manipulation_api
node_manipulation_api -->|"delegates motion"| node_arm_controller
node_manipulation_api -->|"updates scene"| node_collision_manager
node_arm_controller -.->|"plans and executes"| node_move_group
node_arm_controller -.->|"sends trajectories"| node_robot_control
node_collision_manager -->|"applies objects"| node_planning_scene
node_collision_manager -->|"publishes markers"| node_rviz
node_operator -->|"starts filter"| node_obstacle_launch
node_obstacle_launch -->|"starts node"| node_obstacle_main
node_obstacle_main -->|"constructs node"| node_obstacle_filter
node_lidar -->|"provides cloud"| node_obstacle_filter
node_tf -->|"provides transforms"| node_obstacle_filter
node_obstacle_filter -->|"publishes cloud"| node_filtered_cloud
node_filtered_cloud -->|"feeds mapping"| node_octomap
node_moveit_launch -.->|"optionally starts"| node_obstacle_launch

click node_moveit_launch "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/launch/move_group.launch.py"
click node_robot_model "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/config/g1_29dof.urdf.xacro"
click node_manipulation_api "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/unitree_moveit_interface.cpp"
click node_arm_controller "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/arm_controller.cpp"
click node_collision_manager "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/collision_manager.cpp"
click node_obstacle_launch "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/launch/obstacle_remover.launch.py"
click node_obstacle_main "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/src/obstacle_remover_node_main.cpp"
click node_obstacle_filter "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/src/obstacle_remover_node.cpp"
click node_octomap "https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/config/sensors_3d_task_2.yaml"

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_moveit_launch,node_robot_model,node_move_group toneBlue
class node_manipulation_api,node_arm_controller toneAmber
class node_collision_manager,node_planning_scene toneMint
class node_obstacle_launch,node_obstacle_main,node_obstacle_filter,node_octomap toneRose
class node_operator,node_robot_control,node_rviz,node_lidar,node_tf,node_filtered_cloud toneIndigo
```

## Components

### MoveIt Setup

- [MoveIt Launch](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/launch/move_group.launch.py): `g1_moveit/launch/move_group.launch.py`
- [G1 Robot Model](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/config/g1_29dof.urdf.xacro): `g1_moveit/config/g1_29dof.urdf.xacro`
- **MoveIt Move Group**

### Arm Manipulation

- [Manipulation Interface](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/unitree_moveit_interface.cpp): `unitree_arms/src/unitree_moveit_interface.cpp`
- [Arm Controller](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/arm_controller.cpp): `unitree_arms/src/arm_controller.cpp`

### Collision Scene

- [Collision Manager](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/unitree_arms/src/collision_manager.cpp): `unitree_arms/src/collision_manager.cpp`
- **Planning Scene**

### Obstacle Filtering

- [Filter Launch](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/launch/obstacle_remover.launch.py): `obstacle_remover_node/launch/obstacle_remover.launch.py`
- [Filter Entry](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/src/obstacle_remover_node_main.cpp): `obstacle_remover_node/src/obstacle_remover_node_main.cpp`
- [Cloud Filter](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/obstacle_remover_node/src/obstacle_remover_node.cpp): `obstacle_remover_node/src/obstacle_remover_node.cpp`
- [MoveIt OctoMap](https://github.com/xchallenge-zespol-pw/unitree_moveit2/blob/main/g1_moveit/config/sensors_3d_task_2.yaml): `g1_moveit/config/sensors_3d_task_2.yaml`

### Other components

- **Operator**
- **Robot Controllers**
- **RViz**
- **Lidar Cloud**
- **TF Frames**
- **Filtered Cloud**

## Connections

- Operator → MoveIt Launch: starts (evidence: `g1_moveit/launch/move_group.launch.py`)
- MoveIt Launch → G1 Robot Model: loads model (evidence: `g1_moveit/launch/move_group.launch.py`)
- MoveIt Launch → MoveIt Move Group: starts (evidence: `g1_moveit/launch/move_group.launch.py`)
- Operator → Manipulation Interface: requests motions
- Manipulation Interface → Arm Controller: delegates motion (evidence: `unitree_arms/src/unitree_moveit_interface.cpp`)
- Manipulation Interface → Collision Manager: updates scene (evidence: `unitree_arms/src/unitree_moveit_interface.cpp`)
- Arm Controller → MoveIt Move Group: plans and executes
- Arm Controller → Robot Controllers: sends trajectories
- Collision Manager → Planning Scene: applies objects (evidence: `unitree_arms/src/collision_manager.cpp`)
- Collision Manager → RViz: publishes markers (evidence: `unitree_arms/src/collision_manager.cpp`)
- Operator → Filter Launch: starts filter (evidence: `obstacle_remover_node/launch/obstacle_remover.launch.py`)
- Filter Launch → Filter Entry: starts node (evidence: `obstacle_remover_node/launch/obstacle_remover.launch.py`)
- Filter Entry → Cloud Filter: constructs node (evidence: `obstacle_remover_node/src/obstacle_remover_node_main.cpp`)
- Lidar Cloud → Cloud Filter: provides cloud
- TF Frames → Cloud Filter: provides transforms
- Cloud Filter → Filtered Cloud: publishes cloud
- Filtered Cloud → MoveIt OctoMap: feeds mapping
- MoveIt Launch → Filter Launch: optionally starts
