Skip to content

Getting Started

SLAMLab is an easy-to-use, easy-to-integrate framework for localization and mapping.

There are two main ways to use SLAMLab: Offline processing and ROS 2 integration.

Process a recorded sequence from disk with slamlab-offline. The sensor data must be provided in the SLAMLab format. Use slamlab-visualization to inspect the SLAM solution in real time, and slamlab-render to render a video of the results.

graph TD
    A[(sensor data)]
    B([slamlab-offline])
    C([slamlab-visualization])
    A --> B <--> C

If you have a ROS 2 bag containing the sensor data, use first slamlab-offline-importer to convert it to the SLAMLab format, then process as above.

graph TD
    A{{rosbag}}
    B([slamlab-offline-importer])
    C[(sensor data)]
    D([slamlab-offline])
    E([slamlab-visualization])
    A --> B --> C  --> D <--> E

Use the ROS 2 package to run SLAMLab as a ROS 2 node that subscribes to sensor data topics — either live from sensors or replayed from a rosbag.

graph TD
    A{{ros2 messages}}
    B{{ros2 run slamlab slam}}
    C([slamlab-visualization])
    A --> B --> C