# froov30/digital_twin---mitsubishi_industrial_robot architecture

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

- Interactive diagram: https://gitdiagram.com/froov30/digital_twin---mitsubishi_industrial_robot
- Repository: https://github.com/froov30/digital_twin---mitsubishi_industrial_robot

## Overview

RV-8CRL Motion is a ROS 2/MoveIt workcell project combining closed-form inverse kinematics, motion planning, seeded pick-and-place, and a Gazebo factory simulation. The user-facing flow is to launch the configured robot and planning stack, run a task through MoveGroup, and—on the factory path—coordinate conveyor and grasp behavior in simulation. A separate benchmark branch generates planning inputs, measures planner performance, validates trajectories, and reports results. Some subsystem links are documented in the README; unsampled implementation details are represented only at their supported package paths.

Main entry points: [`source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py`](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py) (Conveyor-cell task), [`source/rv8crl_moveit_config`](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/tree/master/source/rv8crl_moveit_config) (MoveGroup), [`source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py`](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py) (MoveIt configuration), [`source/rv8crl_moveit_config/launch/demo.launch.py`](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/launch/demo.launch.py) (Mock demo launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_robot["Robot kinematics"]
  node_analytic["Analytic IK<br/>[rv8crl_ik.cpp]"]
  node_ik_plugin["MoveIt IK plugin<br/>[moveit_plugin.cpp]"]
  node_description["Robot description"]
end

subgraph group_planning["Motion planning"]
  node_moveit_config["MoveIt configuration<br/>[__init__.py]"]
  node_launch["Mock demo launch<br/>[demo.launch.py]"]
  node_move_group["MoveGroup"]
end

subgraph group_tasks["Task execution"]
  node_motion_client["Motion client<br/>[motion.py]"]
  node_pick_place["Pick-place task<br/>[pick_place.py]"]
  node_conveyor_task["Conveyor-cell task<br/>[conveyor_cell.py]"]
end

subgraph group_simulation["Factory simulation"]
  node_cell_model["Cell geometry<br/>[cell.py]"]
  node_world_generator["World generator<br/>[make_world.py]"]
  node_factory_launch["Factory launch<br/>[factory.launch.py]"]
  node_joint_filter["Joint-state filter"]
  node_conveyor_plugin["Conveyor system"]
  node_grasp_plugin["Grasp attachment"]
end

subgraph group_evaluation["Benchmarking"]
  node_scene_generator["Scene/query generator"]
  node_benchmark["Planning benchmark<br/>[run_bench.cpp]"]
  node_bench_common["Benchmark validation<br/>[bench_common.cpp]"]
  node_comparison["Planner comparison"]
  node_report["Result reporting<br/>[make_report.py]"]
end

node_operator(("Operator"))
node_gazebo(("Gazebo simulator"))
node_controller["Robot controller"]

node_operator -->|"launches demo"| node_launch
node_launch -->|"builds parameters"| node_moveit_config
node_moveit_config -->|"configures model"| node_description
node_moveit_config -->|"selects IK"| node_ik_plugin
node_analytic -->|"solves poses"| node_ik_plugin
node_launch -->|"starts"| node_move_group
node_operator -->|"runs task"| node_pick_place
node_pick_place -->|"uses client"| node_motion_client
node_conveyor_task -->|"uses client"| node_motion_client
node_motion_client -->|"requests motion"| node_move_group
node_move_group -->|"executes trajectory"| node_controller
node_operator -->|"launches cell"| node_factory_launch
node_factory_launch -->|"starts simulation"| node_gazebo
node_world_generator -->|"renders geometry"| node_cell_model
node_conveyor_task -->|"shares geometry"| node_cell_model
node_gazebo -->|"publishes joint states"| node_joint_filter
node_joint_filter -->|"filters joint states"| node_move_group
node_conveyor_task -->|"commands belt"| node_conveyor_plugin
node_conveyor_task -->|"commands grasp"| node_grasp_plugin
node_grasp_plugin -->|"reports grasp state"| node_conveyor_task
node_operator -->|"generates scenes"| node_scene_generator
node_scene_generator -.->|"provides queries"| node_benchmark
node_benchmark -->|"validates paths"| node_bench_common
node_operator -->|"compares planners"| node_comparison
node_comparison -.->|"summarizes results"| node_report

click node_analytic "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_analytic_ik/src/rv8crl_ik.cpp"
click node_ik_plugin "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_analytic_ik/src/moveit_plugin.cpp"
click node_description "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/tree/master/source/rv8crl_description"
click node_moveit_config "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py"
click node_launch "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/launch/demo.launch.py"
click node_move_group "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/tree/master/source/rv8crl_moveit_config"
click node_motion_client "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/motion.py"
click node_pick_place "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/pick_place.py"
click node_conveyor_task "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py"
click node_cell_model "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/rv8crl_gazebo/cell.py"
click node_world_generator "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/scripts/make_world.py"
click node_factory_launch "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/launch/factory.launch.py"
click node_joint_filter "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/rv8crl_gazebo/joint_state_filter.py"
click node_conveyor_plugin "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/src/conveyor_system.cpp"
click node_grasp_plugin "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/src/grasp_attach_system.cpp"
click node_scene_generator "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/generate_scenes.cpp"
click node_benchmark "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/run_bench.cpp"
click node_bench_common "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/bench_common.cpp"
click node_comparison "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/scripts/compare_moveit_benchmarks.py"
click node_report "https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/report/make_report.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_analytic,node_ik_plugin,node_description toneBlue
class node_moveit_config,node_launch,node_move_group toneAmber
class node_motion_client,node_pick_place,node_conveyor_task toneMint
class node_cell_model,node_world_generator,node_factory_launch,node_joint_filter,node_conveyor_plugin,node_grasp_plugin toneRose
class node_scene_generator,node_benchmark,node_bench_common,node_comparison,node_report,node_operator,node_gazebo,node_controller toneIndigo
```

## Components

### Robot kinematics

- [Analytic IK](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_analytic_ik/src/rv8crl_ik.cpp): `source/rv8crl_analytic_ik/src/rv8crl_ik.cpp`
- [MoveIt IK plugin](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_analytic_ik/src/moveit_plugin.cpp): `source/rv8crl_analytic_ik/src/moveit_plugin.cpp`
- [Robot description](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/tree/master/source/rv8crl_description): `source/rv8crl_description`

### Motion planning

- [MoveIt configuration](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py): `source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py`
- [Mock demo launch](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_moveit_config/launch/demo.launch.py): `source/rv8crl_moveit_config/launch/demo.launch.py`
- [MoveGroup](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/tree/master/source/rv8crl_moveit_config): `source/rv8crl_moveit_config`

### Task execution

- [Motion client](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/motion.py): `source/rv8crl_tasks/rv8crl_tasks/motion.py`
- [Pick-place task](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/pick_place.py): `source/rv8crl_tasks/rv8crl_tasks/pick_place.py`
- [Conveyor-cell task](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py): `source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py`

### Factory simulation

- [Cell geometry](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/rv8crl_gazebo/cell.py): `source/rv8crl_gazebo/rv8crl_gazebo/cell.py`
- [World generator](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/scripts/make_world.py): `source/rv8crl_gazebo/scripts/make_world.py`
- [Factory launch](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/launch/factory.launch.py): `source/rv8crl_gazebo/launch/factory.launch.py`
- [Joint-state filter](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/rv8crl_gazebo/joint_state_filter.py): `source/rv8crl_gazebo/rv8crl_gazebo/joint_state_filter.py`
- [Conveyor system](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/src/conveyor_system.cpp): `source/rv8crl_gazebo/src/conveyor_system.cpp`
- [Grasp attachment](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_gazebo/src/grasp_attach_system.cpp): `source/rv8crl_gazebo/src/grasp_attach_system.cpp`

### Benchmarking

- [Scene/query generator](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/generate_scenes.cpp): `source/rv8crl_bench/src/generate_scenes.cpp`
- [Planning benchmark](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/run_bench.cpp): `source/rv8crl_bench/src/run_bench.cpp`
- [Benchmark validation](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/src/bench_common.cpp): `source/rv8crl_bench/src/bench_common.cpp`
- [Planner comparison](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/scripts/compare_moveit_benchmarks.py): `source/rv8crl_bench/scripts/compare_moveit_benchmarks.py`
- [Result reporting](https://github.com/froov30/digital_twin---mitsubishi_industrial_robot/blob/master/source/rv8crl_bench/report/make_report.py): `source/rv8crl_bench/report/make_report.py`

### Other components

- **Operator**
- **Gazebo simulator**
- **Robot controller**

## Connections

- Operator → Mock demo launch: launches demo (evidence: `source/rv8crl_moveit_config/launch/demo.launch.py`)
- Mock demo launch → MoveIt configuration: builds parameters (evidence: `source/rv8crl_moveit_config/launch/demo.launch.py`)
- MoveIt configuration → Robot description: configures model (evidence: `source/rv8crl_moveit_config/rv8crl_moveit_config/__init__.py`)
- MoveIt configuration → MoveIt IK plugin: selects IK
- Analytic IK → MoveIt IK plugin: solves poses (evidence: `source/rv8crl_analytic_ik/src/moveit_plugin.cpp`)
- Mock demo launch → MoveGroup: starts (evidence: `source/rv8crl_moveit_config/launch/demo.launch.py`)
- Operator → Pick-place task: runs task
- Pick-place task → Motion client: uses client (evidence: `source/rv8crl_tasks/rv8crl_tasks/pick_place.py`)
- Conveyor-cell task → Motion client: uses client (evidence: `source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py`)
- Motion client → MoveGroup: requests motion (evidence: `source/rv8crl_tasks/rv8crl_tasks/motion.py`)
- MoveGroup → Robot controller: executes trajectory
- Operator → Factory launch: launches cell
- Factory launch → Gazebo simulator: starts simulation
- World generator → Cell geometry: renders geometry (evidence: `source/rv8crl_gazebo/scripts/make_world.py`)
- Conveyor-cell task → Cell geometry: shares geometry (evidence: `source/rv8crl_tasks/rv8crl_tasks/conveyor_cell.py`)
- Gazebo simulator → Joint-state filter: publishes joint states
- Joint-state filter → MoveGroup: filters joint states
- Conveyor-cell task → Conveyor system: commands belt
- Conveyor-cell task → Grasp attachment: commands grasp
- Grasp attachment → Conveyor-cell task: reports grasp state
- Operator → Scene/query generator: generates scenes
- Scene/query generator → Planning benchmark: provides queries
- Planning benchmark → Benchmark validation: validates paths (evidence: `source/rv8crl_bench/src/run_bench.cpp`)
- Operator → Planner comparison: compares planners
- Planner comparison → Result reporting: summarizes results
