Skip to content

slamlab-visualization

Visualizes SLAM results in real time, either from slamlab-offline or from a live ROS 2 node.

Terminal window
slamlab-visualization # default configuration
slamlab-visualization <config_filepath> # custom configuration

Without arguments, the built-in default configuration is used. With one argument, the specified YAML configuration file is loaded. The executable reads the slamlab_visualization section.

The visualization acts as a TCP server, waiting for incoming connections from the SLAM processor:

PortProtocolPurpose
5000TCP (server)Receives per-frame SLAM data
5001TCP (server)Receives async data (global map, prior map)
5002UDP (client)Sends control commands to the SLAM processor

When a client disconnects, the visualization resets its state and waits for a new connection.

StructureTypeDescription
Processed cloudPoint cloudCurrent filtered and deskewed point cloud
Local map voxel PCAPoint cloudVoxel PCA centroids
Prior map voxel PCAPoint cloudVoxel PCA centroids from the prior map
Global mapPoint cloudAccumulated global map
CorrespondencesPoint cloudICP correspondences between processed point cloud and local map
TrajectoryCurve networkEstimated trajectory
FramesCurve networkMap origin and current base frame coordinate axes
Absolute position measurementsPoint cloudIntegrated absolute position measurements (e.g., GNSS)
Key point cloudsPoint cloudOrigin of key point clouds used for loop closure detection
Loop closuresCurve networkLines connecting loop closure pairs
Mesh (base frame)Surface meshOptional mesh attached to the current pose
Mesh (map frame)Surface meshOptional mesh at the map origin
  • Pause / Resume — Sends a pause or resume command to the connected SLAM processor (works only with slamlab-offline)
  • Step — Advances one SLAM iteration when paused (works only with slamlab-offline)
  • Reset — Resets the camera view
  • Polyscope menu — Toggles the native Polyscope GUI for fine-grained structure editing.
  • Camera mode — Free, Follow position, Follow pose, Follow orbit, Top view, or Follow chase. Follow chase shows sliders for distance, azimuth, elevation and smoothing.
  • Scale — Scene length scale (2–200). Use this to globally adjust the size of visualized structures.
  • Load / Save / Save As — Load and save Polyscope configurations as YAML files.

Displays timestamped images synchronized with the trajectory, either from a directory on disk or streamed from the SLAM processor.

  • Trajectory — 3D path (switchable to XY/XZ/YZ), velocity, IMU biases, pose covariance.
  • Correspondences — Count, mean residual, and standard deviation per point cloud.
  • Iterations & Time — ICP iteration count and processing time per point cloud.

Selectable list of loop closure pairs with an Inspect button that opens a window showing the two associated key point clouds for visual inspection.

KeyAction
SpaceToggle pause/resume
Right ArrowSingle step (when paused)
Up / Down ArrowNavigate loop closure pairs
IPrint camera transforms to console
PToggle Polyscope menu
LToggle eye-dome lighting
Ctrl+LReset camera view
ModeBehavior
FreeFull manual camera control
Follow positionCamera tracks the base frame position, but not orientation
Follow poseCamera is rigidly attached to the base frame
Follow orbitCamera orbits around the base frame
Follow chaseCamera follows the base from a configurable distance, azimuth and elevation relative to the direction of travel. Elevation is measured in the map frame, so vehicle roll and pitch do not tilt the view. Camera motion is low-pass filtered.