# cable-disentanglement-workspace/bimanual_ur10e_motion_planner architecture

> Architecture diagram of the GitHub repository cable-disentanglement-workspace/bimanual_ur10e_motion_planner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner
- Repository: https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner

## Overview

This ROS 2 workspace supports bimanual UR10e motion planning and collision avoidance, plus an ArUco-to-MoveIt planning workflow. The principal documented workflow brings up the dual-arm stack, accepts a planned or interactive arm motion, and relies on MoveIt and the robot controllers to plan and execute safely. A separate planner reads a marker pose, applies hand-eye calibration, computes a TCP goal, and requests a plan. Some relationships are documented only at launch/workflow level; unsampled runtime wiring is not inferred.

Main entry points: [`src/dual_arm_moveit_config/launch/move_group.launch.py`](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/move_group.launch.py) (MoveIt move_group), [`src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py`](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py) (Fake-hardware launch), [`src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py`](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py) (Real-hardware launch), [`src/aruco_moveit_planner/aruco_moveit_planner/main.py`](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/main.py) (ArUco planner entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bringup["Robot Bringup"]
  node_dual_model["Dual-arm model"]
  node_moveit_config["MoveIt configuration"]
  node_fake_launch["Fake-hardware launch"]
  node_real_launch["Real-hardware launch"]
  node_move_group["MoveIt move_group"]
  node_controllers["Arm controllers"]
end

subgraph group_avoidance["Motion and Safety"]
  node_collision_script["Collision avoidance"]
  node_arm_motion["Arm motion planning"]
  node_arm_commands["Single-arm commands<br/>[move_arm.py]"]
end

subgraph group_aruco["ArUco Planning"]
  node_pose_input["Marker pose input<br/>[pose_reader.py]"]
  node_planner_entry["ArUco planner entry<br/>[main.py]"]
  node_frame_transform["Frame transforms"]
  node_plan_client["Plan-only client<br/>[moveit_planner.py]"]
end

subgraph group_calibration["Calibration"]
  node_calib_files["Hand-eye calibrations"]
  node_easy_handeye["easy_handeye2"]
end

node_operator(("Operator"))
node_zed["ZED camera"]
node_aruco_ros["ArUco detector"]
node_robot["UR10e arms"]
node_rviz["RViz"]

node_operator -->|"launch offline"| node_fake_launch
node_operator -->|"launch hardware"| node_real_launch
node_fake_launch -->|"loads model"| node_dual_model
node_fake_launch -->|"starts planning"| node_move_group
node_fake_launch -->|"starts visualization"| node_rviz
node_real_launch -->|"loads model"| node_dual_model
node_real_launch -->|"starts planning"| node_move_group
node_real_launch -.->|"starts controllers"| node_controllers
node_moveit_config -.->|"configures planning"| node_move_group
node_operator -->|"run avoidance"| node_collision_script
node_operator -->|"request motion"| node_arm_commands
node_collision_script -.->|"requests safe motion"| node_move_group
node_arm_motion -.->|"executes plans"| node_robot
node_operator -->|"start planning"| node_planner_entry
node_planner_entry -->|"reads pose"| node_pose_input
node_planner_entry -->|"transforms pose"| node_frame_transform
node_planner_entry -->|"requests plan"| node_plan_client
node_frame_transform -->|"loads calibration"| node_calib_files
node_pose_input -.->|"subscribes pose"| node_aruco_ros
node_zed -->|"provides images"| node_aruco_ros
node_plan_client -->|"sends plan request"| node_move_group
node_move_group -->|"publishes trajectory"| node_rviz
node_easy_handeye -.->|"produces calibration"| node_calib_files
node_move_group -.->|"dispatches trajectories"| node_controllers
node_controllers -.->|"commands arms"| node_robot

click node_dual_model "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/config/dual_arm_real_v2.urdf.xacro"
click node_moveit_config "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/tree/main/src/dual_arm_moveit_config/config"
click node_fake_launch "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py"
click node_real_launch "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py"
click node_move_group "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/move_group.launch.py"
click node_controllers "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/config/ros2_controllers.yaml"
click node_collision_script "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_pkg/scripts/move_until_collision.py"
click node_arm_motion "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_python/dual_arm_python/arm_motion_planning.py"
click node_arm_commands "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/move_arm.py"
click node_pose_input "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/pose_reader.py"
click node_planner_entry "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/main.py"
click node_frame_transform "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/frame_transformer.py"
click node_plan_client "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py"
click node_calib_files "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/tree/main/calibrations"
click node_easy_handeye "https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_pkg/launch/handeye_calibrate.launch.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_dual_model,node_moveit_config,node_fake_launch,node_real_launch,node_move_group,node_controllers toneBlue
class node_collision_script,node_arm_motion,node_arm_commands toneAmber
class node_pose_input,node_planner_entry,node_frame_transform,node_plan_client toneMint
class node_calib_files,node_easy_handeye toneRose
class node_operator,node_zed,node_aruco_ros,node_robot,node_rviz toneIndigo
```

## Components

### Robot Bringup

- [Dual-arm model](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/config/dual_arm_real_v2.urdf.xacro): `src/dual_arm_moveit_config/config/dual_arm_real_v2.urdf.xacro`
- [MoveIt configuration](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/tree/main/src/dual_arm_moveit_config/config): `src/dual_arm_moveit_config/config`
- [Fake-hardware launch](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py): `src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py`
- [Real-hardware launch](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py): `src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py`
- [MoveIt move_group](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/launch/move_group.launch.py): `src/dual_arm_moveit_config/launch/move_group.launch.py`
- [Arm controllers](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_moveit_config/config/ros2_controllers.yaml): `src/dual_arm_moveit_config/config/ros2_controllers.yaml`

### Motion and Safety

- [Collision avoidance](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_pkg/scripts/move_until_collision.py): `src/dual_arm_pkg/scripts/move_until_collision.py`
- [Arm motion planning](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_python/dual_arm_python/arm_motion_planning.py): `src/dual_arm_python/dual_arm_python/arm_motion_planning.py`
- [Single-arm commands](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/move_arm.py): `src/aruco_moveit_planner/aruco_moveit_planner/move_arm.py`

### ArUco Planning

- [Marker pose input](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/pose_reader.py): `src/aruco_moveit_planner/aruco_moveit_planner/pose_reader.py`
- [ArUco planner entry](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/main.py): `src/aruco_moveit_planner/aruco_moveit_planner/main.py`
- [Frame transforms](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/frame_transformer.py): `src/aruco_moveit_planner/aruco_moveit_planner/frame_transformer.py`
- [Plan-only client](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py): `src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py`

### Calibration

- [Hand-eye calibrations](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/tree/main/calibrations): `calibrations`
- [easy_handeye2](https://github.com/cable-disentanglement-workspace/bimanual_ur10e_motion_planner/blob/main/src/dual_arm_pkg/launch/handeye_calibrate.launch.py): `src/dual_arm_pkg/launch/handeye_calibrate.launch.py`

### Other components

- **Operator**
- **ZED camera**
- **ArUco detector**
- **UR10e arms**
- **RViz**

## Connections

- Operator → Fake-hardware launch: launch offline (evidence: `README.md`)
- Operator → Real-hardware launch: launch hardware (evidence: `README.md`)
- Fake-hardware launch → Dual-arm model: loads model (evidence: `src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py`)
- Fake-hardware launch → MoveIt move_group: starts planning (evidence: `src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py`)
- Fake-hardware launch → RViz: starts visualization (evidence: `src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py`)
- Real-hardware launch → Dual-arm model: loads model (evidence: `README.md`)
- Real-hardware launch → MoveIt move_group: starts planning (evidence: `README.md`)
- Real-hardware launch → Arm controllers: starts controllers
- MoveIt configuration → MoveIt move_group: configures planning
- Operator → Collision avoidance: run avoidance (evidence: `README.md`)
- Operator → Single-arm commands: request motion
- Collision avoidance → MoveIt move_group: requests safe motion
- Arm motion planning → UR10e arms: executes plans
- Operator → ArUco planner entry: start planning (evidence: `src/aruco_moveit_planner/aruco_moveit_planner/main.py`)
- ArUco planner entry → Marker pose input: reads pose (evidence: `src/aruco_moveit_planner/aruco_moveit_planner/main.py`)
- ArUco planner entry → Frame transforms: transforms pose (evidence: `src/aruco_moveit_planner/aruco_moveit_planner/main.py`)
- ArUco planner entry → Plan-only client: requests plan (evidence: `src/aruco_moveit_planner/aruco_moveit_planner/main.py`)
- Frame transforms → Hand-eye calibrations: loads calibration
- Marker pose input → ArUco detector: subscribes pose
- ZED camera → ArUco detector: provides images (evidence: `README.md`)
- Plan-only client → MoveIt move_group: sends plan request (evidence: `src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py`)
- MoveIt move_group → RViz: publishes trajectory
- easy_handeye2 → Hand-eye calibrations: produces calibration
- MoveIt move_group → Arm controllers: dispatches trajectories
- Arm controllers → UR10e arms: commands arms
