How men3m-4/openarm_sorting works
OpenArm Cup Sorting is a ROS 2 simulation where an operator confirms a task, the RGB-D perception system localizes red and blue cubes, and a coordinator uses MoveIt and the left gripper to place them in one configured cup, verifying motion and placement. The graph also shows robot-description and launch support layers. Relationships for sampled modules are grounded in their excerpts or the source index; launch orchestration and several runtime links rely on the README’s documented architecture, since launch sources were not excerpted here.
Main entry points: coordinator.py Sorting coordinator · cube_detector.py Cube detector · cup_sorting.launch.py Cup sorting launch · robot_description.py Robot description
Components 19
Simulation and bringup
- Cup sorting launch
src/openarm_sorting_bringup/launch/cup_sorting.launch.py - Gazebo world
src/openarm_sorting_bringup/worlds/openarm_cup_sorting_world.sdf - Launch support
src/openarm_sorting_bringup/openarm_sorting_bringup/launch_support.py - Simulated RGB-D camera
src/openarm_sorting_description/urdf/openarm_v20_gazebo.urdf.xacro - Gazebo controllers
src/openarm_sorting_description/config/gazebo_controllers.yaml
Robot description
- Robot description
src/openarm_sorting_description/openarm_sorting_description/robot_description.py - Finger collision patch
src/openarm_sorting_description/openarm_sorting_description/gripper_collision_patch.py
Cube perception
- Cube detector
src/openarm_sorting_vision/openarm_sorting_vision/cube_detector.py - Color segmentation
src/openarm_sorting_vision/openarm_sorting_vision/color_segmentation.py - Camera geometry
src/openarm_sorting_vision/openarm_sorting_vision/camera_geometry.py
Task execution
- Sorting coordinator
src/openarm_sorting_manipulation/openarm_sorting_manipulation/coordinator.py - Task confirmation
src/openarm_sorting_manipulation/openarm_sorting_manipulation/task_prompt.py
Motion and gripper
- Planning scene
src/openarm_sorting_manipulation/openarm_sorting_manipulation/planning_scene.py - MoveIt client
src/openarm_sorting_manipulation/openarm_sorting_manipulation/moveit_interface.py - Left gripper client
src/openarm_sorting_manipulation/openarm_sorting_manipulation/gripper.py - ROS async helpers
src/openarm_sorting_manipulation/openarm_sorting_manipulation/ros_utils.py
Other components
- Operator
- MoveIt move_group
- Gazebo control
Connections 23
- Operator → Cup sorting launch: starts
README.md - Cup sorting launch → Gazebo world: starts simulation
README.md - Cup sorting launch → Cube detector: starts perception
README.md - Cup sorting launch → Sorting coordinator: starts task
README.md - Cup sorting launch → Launch support: uses configuration
src/openarm_sorting_bringup/launch/cup_sorting.launch.py - Launch support → Robot description: loads description
src/openarm_sorting_bringup/openarm_sorting_bringup/launch_support.py - Robot description → Finger collision patch: patches collisions
src/openarm_sorting_description/openarm_sorting_description/robot_description.py - Gazebo world → Simulated RGB-D camera: hosts robot
README.md - Robot description → Gazebo controllers: configures control
README.md - Simulated RGB-D camera → Cube detector: sends RGB-D
README.md - Cube detector → Color segmentation: uses masks
src/openarm_sorting_vision/openarm_sorting_vision/cube_detector.py - Cube detector → Camera geometry: uses projection
src/openarm_sorting_vision/openarm_sorting_vision/cube_detector.py - Cube detector → Sorting coordinator: publishes cube poses
README.md - Task confirmation → Sorting coordinator: sends confirmation
README.md - Sorting coordinator → Planning scene: builds collision scene
src/openarm_sorting_manipulation/openarm_sorting_manipulation/coordinator.py - Sorting coordinator → MoveIt client: requests motion
src/openarm_sorting_manipulation/openarm_sorting_manipulation/coordinator.py - Sorting coordinator → Left gripper client: commands grasp
src/openarm_sorting_manipulation/openarm_sorting_manipulation/coordinator.py - MoveIt client → MoveIt move_group: plans and executes
README.md - MoveIt client → ROS async helpers: awaits actions
src/openarm_sorting_manipulation/openarm_sorting_manipulation/moveit_interface.py - Left gripper client → ROS async helpers: awaits actions
src/openarm_sorting_manipulation/openarm_sorting_manipulation/gripper.py - MoveIt move_group → Gazebo control: sends trajectories
README.md - Left gripper client → Gazebo control: sends gripper commands
README.md - Sorting coordinator → Cube detector: checks placement by camera
README.md