# berkcalli/rbe4540-gazebo-sim architecture

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

- Interactive diagram: https://gitdiagram.com/berkcalli/rbe4540-gazebo-sim
- Repository: https://github.com/berkcalli/rbe4540-gazebo-sim

## Overview

This repository combines ROS 2 robot-motion and simulation packages, an XYZ point-cloud processing API, shared motion-service definitions, and a Robotiq gripper controller. A user-facing workflow is represented as motion requests handled by the robot interface, with point-cloud processing and simulated scenes available as distinct capabilities. The Python binding module explicitly registers the PCL feature, geometry, filtering, registration, and surface-I/O bindings. Evidence is uneven: those bindings and the gripper activation path are excerpted, while several motion and simulation files are only indexed, so their connections are shown as unverified.

Main entry points: [`rbe4540-sim/pcl_python_merlab/src/bindings.cpp`](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/bindings.cpp) (Python PCL API), [`rbe4540-sim/pcl_python_merlab/src/cloud.hpp`](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/cloud.hpp) (Cloud Core), [`ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp`](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp) (Activation Controller), [`rbe4540-sim/ur_move_merlab/ur_move_merlab/ur_move_simple_interface.py`](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/ur_move_simple_interface.py) (Motion Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_motion["Robot Motion"]
  node_motion_api["Motion Services"]
  node_pick_place["Pick Place Demo<br/>[pick_place_demo.py]"]
end

subgraph group_cloud["Point Clouds"]
  node_pc_workflow["PC Processing"]
  node_pcl_api["Python PCL API<br/>[bindings.cpp]"]
  node_cloud_core["Cloud Core<br/>[cloud.hpp]"]
  node_filters["Cloud Filters<br/>[filters.cpp]"]
  node_geometry["Geometry Tools<br/>[geometry.cpp]"]
  node_features["Cloud Features<br/>[features.cpp]"]
  node_registration["Cloud Registration<br/>[registration.cpp]"]
  node_surface_io["Surface and I/O<br/>[surface_io.cpp]"]
end

subgraph group_sim["Simulation"]
  node_sim_scene["Simulation Scenes"]
  node_sim_control["Robot Simulation"]
end

subgraph group_gripper["Robotiq Gripper"]
  node_gripper_launch["Gripper Control Launch"]
  node_activation["Activation Controller"]
  node_activation_api["Controller Interface"]
end

node_operator(("Operator"))
node_gripper_hardware["Gripper Hardware"]

node_operator -.->|"requests motion"| node_motion_api
node_motion_api -.->|"used by demo"| node_pick_place
node_pick_place -.->|"uses processing"| node_pc_workflow
node_pc_workflow -.->|"uses bindings"| node_pcl_api
node_pcl_api -->|"registers cloud"| node_cloud_core
node_pcl_api -->|"binds filters"| node_filters
node_pcl_api -->|"binds geometry"| node_geometry
node_pcl_api -->|"binds features"| node_features
node_pcl_api -->|"binds registration"| node_registration
node_pcl_api -->|"binds surface I/O"| node_surface_io
node_filters -->|"uses cloud types"| node_cloud_core
node_geometry -->|"uses cloud types"| node_cloud_core
node_features -->|"uses cloud types"| node_cloud_core
node_registration -->|"uses cloud types"| node_cloud_core
node_surface_io -->|"uses cloud types"| node_cloud_core
node_operator -.->|"starts scene"| node_sim_scene
node_sim_scene -.->|"loads control"| node_sim_control
node_gripper_launch -->|"spawns controller"| node_activation
node_activation -->|"implements interface"| node_activation_api
node_operator -.->|"calls service"| node_activation
node_activation -.->|"sets command interfaces"| node_gripper_hardware

click node_motion_api "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/ur_move_simple_interface.py"
click node_pick_place "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/pick_place_demo.py"
click node_pc_workflow "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/pc_processing_template.py"
click node_pcl_api "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/bindings.cpp"
click node_cloud_core "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/cloud.hpp"
click node_filters "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/filters.cpp"
click node_geometry "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/geometry.cpp"
click node_features "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/features.cpp"
click node_registration "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/registration.cpp"
click node_surface_io "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/surface_io.cpp"
click node_sim_scene "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/simple_pick_place_scene.launch.py"
click node_sim_control "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/ur_sim_control.launch.py"
click node_gripper_launch "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_description/launch/robotiq_control.launch.py"
click node_activation "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp"
click node_activation_api "https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_controllers/include/robotiq_controllers/robotiq_activation_controller.hpp"

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_motion_api,node_pick_place toneBlue
class node_pc_workflow,node_pcl_api,node_cloud_core,node_filters,node_geometry,node_features,node_registration,node_surface_io toneAmber
class node_sim_scene,node_sim_control toneMint
class node_gripper_launch,node_activation,node_activation_api toneRose
class node_operator,node_gripper_hardware toneIndigo
```

## Components

### Robot Motion

- [Motion Services](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/ur_move_simple_interface.py): `rbe4540-sim/ur_move_merlab/ur_move_merlab/ur_move_simple_interface.py`
- [Pick Place Demo](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/pick_place_demo.py): `rbe4540-sim/ur_move_merlab/ur_move_merlab/pick_place_demo.py`

### Point Clouds

- [PC Processing](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_move_merlab/ur_move_merlab/pc_processing_template.py): `rbe4540-sim/ur_move_merlab/ur_move_merlab/pc_processing_template.py`
- [Python PCL API](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/bindings.cpp): `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`
- [Cloud Core](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/cloud.hpp): `rbe4540-sim/pcl_python_merlab/src/cloud.hpp`
- [Cloud Filters](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/filters.cpp): `rbe4540-sim/pcl_python_merlab/src/filters.cpp`
- [Geometry Tools](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/geometry.cpp): `rbe4540-sim/pcl_python_merlab/src/geometry.cpp`
- [Cloud Features](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/features.cpp): `rbe4540-sim/pcl_python_merlab/src/features.cpp`
- [Cloud Registration](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/registration.cpp): `rbe4540-sim/pcl_python_merlab/src/registration.cpp`
- [Surface and I/O](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/pcl_python_merlab/src/surface_io.cpp): `rbe4540-sim/pcl_python_merlab/src/surface_io.cpp`

### Simulation

- [Simulation Scenes](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/simple_pick_place_scene.launch.py): `rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/simple_pick_place_scene.launch.py`
- [Robot Simulation](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/ur_sim_control.launch.py): `rbe4540-sim/ur_simulation_gz/ur_simulation_gz/launch/ur_sim_control.launch.py`

### Robotiq Gripper

- [Gripper Control Launch](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_description/launch/robotiq_control.launch.py): `ros2_robotiq_gripper/robotiq_description/launch/robotiq_control.launch.py`
- [Activation Controller](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp): `ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp`
- [Controller Interface](https://github.com/berkcalli/rbe4540-gazebo-sim/blob/main/ros2_robotiq_gripper/robotiq_controllers/include/robotiq_controllers/robotiq_activation_controller.hpp): `ros2_robotiq_gripper/robotiq_controllers/include/robotiq_controllers/robotiq_activation_controller.hpp`

### Other components

- **Operator**
- **Gripper Hardware**

## Connections

- Operator → Motion Services: requests motion
- Motion Services → Pick Place Demo: used by demo
- Pick Place Demo → PC Processing: uses processing
- PC Processing → Python PCL API: uses bindings
- Python PCL API → Cloud Core: registers cloud (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Python PCL API → Cloud Filters: binds filters (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Python PCL API → Geometry Tools: binds geometry (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Python PCL API → Cloud Features: binds features (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Python PCL API → Cloud Registration: binds registration (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Python PCL API → Surface and I/O: binds surface I/O (evidence: `rbe4540-sim/pcl_python_merlab/src/bindings.cpp`)
- Cloud Filters → Cloud Core: uses cloud types (evidence: `rbe4540-sim/pcl_python_merlab/src/filters.cpp`)
- Geometry Tools → Cloud Core: uses cloud types (evidence: `rbe4540-sim/pcl_python_merlab/src/geometry.cpp`)
- Cloud Features → Cloud Core: uses cloud types (evidence: `rbe4540-sim/pcl_python_merlab/src/features.cpp`)
- Cloud Registration → Cloud Core: uses cloud types (evidence: `rbe4540-sim/pcl_python_merlab/src/registration.cpp`)
- Surface and I/O → Cloud Core: uses cloud types (evidence: `rbe4540-sim/pcl_python_merlab/src/surface_io.cpp`)
- Operator → Simulation Scenes: starts scene
- Simulation Scenes → Robot Simulation: loads control
- Gripper Control Launch → Activation Controller: spawns controller (evidence: `ros2_robotiq_gripper/robotiq_description/launch/robotiq_control.launch.py`)
- Activation Controller → Controller Interface: implements interface (evidence: `ros2_robotiq_gripper/robotiq_controllers/src/robotiq_activation_controller.cpp`)
- Operator → Activation Controller: calls service
- Activation Controller → Gripper Hardware: sets command interfaces
