map-saver-config

Configure Nav2 map_saver to persist occupancy grids to YAML and image files.

18|2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-saver-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-saver-config
Source: https://github.com/wimblerobotics/ros2-copilot-skills/tree/main/map-saver-config
Command: npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-saver-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configure Nav2 map saver to save maps from SLAM with thresholds and periodic saving.

Core Features & Use Cases

  • Automatic map saving: Save occupancy grids to YAML + image files with tunable timeouts and thresholds.
  • QoS-aware saving: Use TRANSIENT_LOCAL to capture last published maps for accurate archiving.
  • CLI and Service integration: Save maps via map_saver_cli and /map_saver/save_map service for automation.

Quick Start

Configure the map_saver parameters to automatically save the current map at a defined interval.

Frequently Asked Questions about map-saver-config

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

FAQPage Schema
How do I automatically save Nav2 occupancy grids to disk during a SLAM run?

You can automatically save Nav2 occupancy grids during a SLAM run by configuring the ROS 2 map_saver YAML parameters to define tunable timeouts and thresholds for periodic map persistence to YAML and image files.

What is the best way to configure map saving thresholds in ROS 2 navigation deployments?

Configuring map saving thresholds in ROS 2 navigation deployments involves defining YAML parameters for the Nav2 map_saver to control occupancy grid archiving behavior based on tunable timing and value limits.

How does QoS TRANSIENT_LOCAL work when saving ROS 2 maps?

QoS TRANSIENT_LOCAL works when saving ROS 2 maps by allowing the map_saver to capture the last published occupancy grid, ensuring accurate archiving of the most recent map state during navigation maintenance.

Can I use the map_saver_cli and save_map service to automate ROS 2 map updates?

Yes, you can automate ROS 2 map updates by utilizing the map_saver_cli tool and the /map_saver/save_map service contract to trigger occupancy grid persistence during routine maintenance.

Do I need additional dependencies to periodically save Nav2 maps with configurable timing?

No additional dependencies are required to periodically save Nav2 maps, as the configuration relies solely on YAML parameter definitions and the ROS 2 navigation stack's built-in map_saver component.

Why are my Nav2 map_saver YAML parameter changes not applying to the saved occupancy grid?

Nav2 map_saver YAML parameter changes may not apply if the QoS profile is not set to TRANSIENT_LOCAL, preventing the saver from capturing the correct published map state for disk archiving.