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#

  1. 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.

  2. 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

bag-replay [2D|RS]

adbscan_sub with adbscan_sub_2D.yaml (default, /scan) or adbscan_sub_RS.yaml (/camera/depth/color/points), the bag on a loop, and RViz with the packaged adbscan_RS_config.rviz

bag-replay-check

Headless, one pass of the bag in 2D mode and then RS mode. PASS if /obstacle_array publishes clusters in most messages in both

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/.