FastMapping Workshop#

This tutorial runs FastMapping in a workshop. FastMapping builds a 3D voxel map and a 2D occupancy grid from depth images. The workshop replays the recorded depth bag from ros-${ROS_DISTRO}-bagfile-spinning (about 12 seconds), so no camera is needed.

Prerequisites#

  • A host set up as described in Getting Started.

  • A local desktop session for the RViz step.

Launch the workshop#

cd src/components/fast-mapping/workshop
workshop launch fast-mapping

Build a map without a display#

workshop run fast-mapping bag-replay-headless

The action runs fast_mapping_node on one pass of the bag and prints the number of map updates, the voxel count and the occupancy grid size. On Jazzy it reports 172 map updates (about 30,000 voxels) and a 512 x 512 occupancy grid, with all 46 frames processed.

View the map in RViz#

workshop connect fast-mapping/robotics-ai-suite:desktop
workshop run fast-mapping bag-replay

RViz shows the 3D map on /world/fused_map and the 2D occupancy grid on /world/map as the bag plays. Press Ctrl+C in the terminal to stop.

Actions#

Action

Description

bag-replay

The documented tutorial launch: fast_mapping_node, RViz (/world/fused_map, /world/map) and the bag

bag-replay-headless

The same node and bag without RViz. Prints map update counts, voxel count and occupancy grid size

Humble#

Use fast-mapping-humble in every command. bag-replay-headless reports 165 map updates, with all 46 frames processed.

Source#

The definitions and package list are in src/components/fast-mapping/workshop/.