* rtabmap_demos tests and docs * added bag testing * added rtabmap_examples launch tests * updating demo bag download paths * added netherdrone demo * Fixed rgb-only callback with lidar rejected. Updated lidar params * Added back OrbitOriented rviz view to ros2, with optional octomap wll clipping * fixing ci * lidar demo added intermediate_nodes option * added netherdrone as demo test * running rtabmap_demos tests on ci * added rtabmap_launch tests, fixed ground_truth_base_frame_id usage * ficing rolling * updating demo test harnest * densify golden trajectories to avoid tf missing * fixing tf steps * updated min icp ratio for netherdrone demo * fixing image_transport arg->params * export pose opt=0 * lets process all frames * updated netherdrone golden * fixing publishers queue size just for tests * added playdback demo doc * Adding more logs to debug ci * Fixing QOS for CI to reliable, added find-object demo test * name threads * fixing camera info expected transient on lyrical/rolling. Fixing find_object not appearing idle * 30 Hz polling backward comp * fixing test tf sim lock * fixing lyrical qos bag parsing * faster replay * lockstep * fixing clock deadlock * Added test on shutdown * updated netherdrone golden poses * Extended stereo outdoor test * updated shutdown test * updated test * multi-thread flaky test * adding backtrace when test fails * increased closure slack for netherdrone * g2o gauss newton on stereo * adjusted maximum optimizer iterations * updated default iterations * Added netherdrone in list of demos
rtabmap_demos
Ready-to-run demos of RTAB-Map. Each launch file sets up a complete pipeline for one of the demo bags or one simulated robot, so you can watch RTAB-Map map, close loops and navigate without any hardware. The bags can be downloaded from the 0.23.13 release.
- Outdoor Stereo VSLAM
- Indoor 2D LiDAR and RGB-D SLAM
- Multi-Session Indoor 2D LiDAR and RGB-D SLAM
- Find-Object with SLAM
- Turtlebot4 Nav2, 2D LiDAR and RGB-D SLAM
- Turtlebot3 Nav2 and 2D LiDAR SLAM
- Turtlebot3 Nav2 and RGB-D SLAM
- Turtlebot3 Nav2, 2D LiDAR and RGB-D SLAM
- Turtlebot3 Nav2, Fake 2D LiDAR and RGB-D SLAM
- Turtlebot3 Nav2, 2D LiDAR SLAM with FusionCore (IMU + wheel UKF)
- Champ Quadruped Nav2, Elevation Map and VSLAM
- Clearpath Husky Nav2, 2D LiDAR and RGB-D SLAM
- Clearpath Husky Nav2, 3D LiDAR and RGB-D SLAM
- Clearpath Husky Nav2, 3D LiDAR Assembling and RGB-D SLAM
- Isaac Sim Nav2 and Stereo SLAM
- Isaac Sim Nav2 and RGB-D VSLAM
Outdoor Stereo VSLAM
stereo_outdoor_demo.launch.py (Video)
Indoor 2D LiDAR and RGB-D SLAM
robot_mapping_demo.launch.py (Videos: rtabmap_viz, rviz)
Multi-Session Indoor 2D LiDAR and RGB-D SLAM
multisession_mapping_demo.launch.py (Video)
Find-Object with SLAM
find_object_demo.launch.py (Video)
Netherdrone 3D LiDAR SLAM
netherdrone_lidar3d_demo.launch.py
Turtlebot4 Nav2, 2D LiDAR and RGB-D SLAM
Turtlebot3 Nav2 and 2D LiDAR SLAM
turtlebot3_sim_scan_demo.launch.py
Turtlebot3 Nav2 and RGB-D SLAM
turtlebot3_sim_rgbd_demo.launch.py
Turtlebot3 Nav2, 2D LiDAR and RGB-D SLAM
turtlebot3_sim_rgbd_scan_demo.launch.py
Turtlebot3 Nav2, Fake 2D LiDAR and RGB-D SLAM
turtlebot3_sim_rgbd_fake_scan_demo.launch.py
- Red: Scan generated from camera's depth.
- Orange: Locally assembled scans used for proximity detection.
- Yellow: The map.
Turtlebot3 Nav2, 2D LiDAR SLAM with FusionCore (IMU + wheel UKF)
turtlebot3_sim_fusioncore_icp_demo.launch.py (Jazzy + Gazebo Harmonic)
FusionCore (wheel + IMU UKF) and icp_odometry run in a feedback loop: FusionCore's stable odom frame seeds scan matching via guess_frame_id, and the ICP result feeds back into FusionCore as a second velocity source. See README for architecture details.
Champ Quadruped Nav2, Elevation Map and VSLAM
Clearpath Husky Nav2, 2D LiDAR and RGB-D SLAM
husky_sim_scan2d_demo.launch.py
Clearpath Husky Nav2, 3D LiDAR and RGB-D SLAM
husky_sim_scan3d_demo.launch.py
Clearpath Husky Nav2, 3D LiDAR Assembling and RGB-D SLAM
husky_sim_scan3d_assemble_demo.launch.py
Isaac Sim Nav2 and Stereo SLAM
isaac_sim_vslam_demo.launch.py
Isaac Sim Nav2 and RGB-D VSLAM
isaac_sim_vslam_demo.launch.py stereo:=false vo:=rtabmap
Tests
colcon test --packages-select rtabmap_demos runs two tests:
test_launch_filesloads every launch file of this package, with its default arguments and with each of its switches flipped, without starting anything. It checks that the files, executables, components and included launch files exist, that the arguments passed to our own launch files are declared, and that RTAB-Map's parameters exist in the installed library. Packages that are not installed (simulators, robots) are stubbed and named in a warning.test_demo_playbackreplays demo bags through the demo launch files and compares the resulting graphs with the golden ones intest/golden(number of nodes and of loop closures, and the trajectory error rtabmap computes against the golden trajectory, replayed as ground truth). It is skipped unless the bags were downloaded first (a few GB):
rtabmap_demos/test/fetch_test_data.sh # or set RTABMAP_DEMOS_TEST_DATA to download elsewhere
The bags are replayed in lockstep with the demo's nodes: each sensor message is published only once every node is idle, so results do not depend on how loaded the machine is. A replay takes a few minutes per bag. To keep a run's graph, database and log, set RTABMAP_DEMOS_TEST_RESULTS to a directory. After a change that is expected to change the results, regenerate the golden graphs with RTABMAP_DEMOS_UPDATE_GOLDEN=1 and commit them.