mapping-best-practices

Guides SLAM mapping runs with driving, sensor, and map cleanup practices.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/three1324/yeonjinautomotive --skill mapping-best-practices-three1324
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mapping-best-practices
Source: https://github.com/three1324/yeonjinautomotive/tree/main/.claude/skills/mapping-best-practices
Command: npx skills add https://github.com/three1324/yeonjinautomotive --skill mapping-best-practices-three1324

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Poorly executed SLAM mapping runs produce maps with drift, phantom obstacles, and wall gaps that break robot localization and navigation. This Skill provides proven practices for planning mapping runs, configuring sensors, and cleaning up maps so the result is usable for navigation. ## Core Features & Use Cases - Mapping Run Guidance: Covers driving speed (0.2–0.3 m/s), straight-line paths, loop closure strategy, wall distance, and systematic room-by-room coverage. - Sensor Configuration Rules: Ensures lidar and IMU setups match between mapping and navigation, with checks for scan rate, range limits, and IMU calibration. - Post-Mapping Cleanup: Provides a GIMP workflow for removing exterior artifacts, fixing wall gaps, and erasing ghost obstacles, plus resolution tradeoffs and a validation checklist. - Use Case: Before mapping an office floor with a lidar-equipped robot and SLAM Toolbox, consult this Skill to plan the route, verify sensor settings, save the pose graph, and clean the PGM map before deploying it to Nav2. ## Quick Start Ask the assistant to help plan a SLAM mapping run for your robot and review the resulting map for cleanup before using it for navigation.

Frequently Asked Questions about mapping-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a good SLAM map with a lidar robot?

Drive at 0.2-0.3 m/s in straight lines, stay 0.3-0.5 m from walls, and always close loops by returning to the start point. Map room by room, returning to a central hallway between rooms to add constraints.

What map resolution should I use for indoor SLAM?

Use 0.05 m resolution for typical indoor home or office environments as a good balance of detail and performance. Use 0.025 m only if the robot must navigate passages narrower than 0.5 m.

Can I map with one lidar and navigate with a different one?

No. The sensor setup during mapping must match navigation exactly, including the same lidar, mounting height, and scan parameters. Mismatched coverage creates blind spots or phantom obstacles in the costmap.

How do I clean up a SLAM map in GIMP?

Open the PGM file, flood-fill exterior artifacts with value 205, fill wall gaps with black using a 1-3 px pencil, erase stray noise pixels, then export as PGM or PNG. Keep the raw unedited map as a backup.

Why does my SLAM map have phantom walls or drift?

Phantom walls often come from mirrors or glass causing specular reflections, while drift comes from fast driving, excessive turning, or a noisy uncalibrated IMU. Slow down, cap max_range, and disable a bad IMU rather than using it.

What files should I save after a SLAM mapping session?

Save the PGM/YAML map, the serialized pose graph (.posegraph and .data) for lifelong mode, a raw unedited PGM backup, and optionally a rosbag of /scan, /odom, /tf, and /imu/data for replaying with different parameters.