ADBSCAN Workshop#
This tutorial runs ADBSCAN obstacle clustering in a workshop. ADBSCAN clusters 2D laser scans or 3D point clouds into obstacles, and publishes them on /obstacle_array (nav2_dynamic_msgs/ObstacleArray) and /marker_array. The workshop runs adbscan_sub on the recorded bag from ros-${ROS_DISTRO}-bagfile-laser-pointcloud (about 18 seconds of /scan, /camera/depth/color/points and /camera/color/image_raw), so no sensor is needed.
Prerequisites#
A host set up as described in Getting Started, with robotics-installer v2026.3.12 or later. Earlier installers don’t provide PCL 1.15, which the package needs.
A local desktop session for the RViz step.
Launch the workshop#
cd src/components/adbscan/workshop
workshop launch adbscan
Check clustering without a display#
workshop run adbscan bag-replay-check
The action replays the bag once in 2D mode (laser scan) and once in RS mode (RealSense™ point cloud), and prints PASS if /obstacle_array publishes clusters in most messages in both. On Jazzy, 2D mode publishes at about 2 Hz with 17 to 24 obstacles per message, and RS mode at about 1.5 Hz with 2 to 4.
View the clusters in RViz#
Connect the desktop and replay the bag in 2D mode:
workshop connect adbscan/robotics-ai-suite:desktop workshop run adbscan bag-replay
RViz shows the laser scan, the camera image and the cluster markers. The bag plays in a loop; press Ctrl+C in the terminal to stop.
Replay it in RS mode, which clusters the depth camera’s point cloud:
workshop run adbscan bag-replay RS
The node stamps its markers in the map frame, which the bag’s transforms don’t contain, so bag-replay publishes an identity map to laser transform to draw the clusters over the scan. Each time the bag loops, RViz logs TF_OLD_DATA warnings.
Actions#
Action |
Description |
|---|---|
|
|
|
Headless, one pass of the bag in 2D mode and then RS mode. PASS if |
The package has no launch files, so the actions start adbscan_sub directly with the packaged configuration files. The follow-me application is not part of this workshop.
Humble#
Use adbscan-humble in every command. ros-humble-adbscan-ros2 2.3-3 links PCL 1.15 but doesn’t declare it as a dependency, so the node exits with:
error while loading shared libraries: libpcl_common.so.1.15: cannot open shared object file
A packaging fix is in progress. Until it is released, install the libraries after launching the workshop:
workshop exec adbscan-humble -- bash -c 'set -a; . /etc/environment; set +a; sudo -E apt-get install -y libpcl-common1.15 libpcl-filters1.15 libpcl-kdtree1.15 libpcl-segmentation1.15'
With them, bag-replay-check passes in both modes. A rebuild removes the libraries; install them again afterwards.
Source#
The definitions, package list and check script are in src/components/adbscan/workshop/.