Map saving and loading in ROS - Step-by-Step Execution

Concept Flow - Map saving and loading

Start ROS Node

↓

Run map_saver

↓

Map data saved to file

↓

Run map_server

↓

Map data loaded from file

↓

Map available for navigation

The flow shows starting a ROS node, saving the map to a file, then loading it back for use.

Execution Sample

ROS

rosrun map_server map_saver -f my_map
rosrun map_server map_server my_map

This saves the current map to 'my_map' files and then loads it back for navigation.

Execution Table

Step	Action	Input/Command	Result	Notes
1	Start ROS node	roscore	ROS master running	ROS environment ready
2	Save map	rosrun map_server map_saver -f my_map	Files my_map.pgm and my_map.yaml created	Map data saved to disk
3	Load map	rosrun map_server map_server my_map	Map loaded into ROS	Map available for navigation
4	Use map	Navigation stack starts	Robot uses saved map	Map data used for localization and planning
5	Exit	Stop nodes	ROS nodes shut down	Process ends

💡 All steps complete, map saved and loaded successfully for robot use

Variable Tracker

Variable	Start	After Save	After Load	Final
map_file	none	my_map.yaml + my_map.pgm	my_map loaded	map data ready

Key Moments - 2 Insights

Why do we need both .pgm and .yaml files when saving a map?

The .pgm file stores the image of the map, while the .yaml file contains metadata like resolution and origin. Both are needed to fully restore the map (see execution_table step 2).

What happens if we try to load a map before saving it?

Loading will fail because the map files don't exist yet. The execution_table shows saving must happen first (step 2) before loading (step 3).

Visual Quiz - 3 Questions

Look at the execution_table, what files are created after the save step?

A my_map.pgm and my_map.yaml

B my_map.txt and my_map.yaml

C my_map.pgm only

D No files are created

💡 Hint

Check row 2 under Result column in execution_table

At which step does the map become available for navigation?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Look at the Notes column in execution_table rows 3 and 4

If the .yaml file is missing, what will happen when loading the map?

A Map loads normally

B Only the image loads but no metadata

C Map loading fails due to missing metadata

D ROS crashes

💡 Hint

Refer to key_moments about the role of .yaml file

Concept Snapshot

Map saving and loading in ROS:
- Use 'rosrun map_server map_saver -f filename' to save map
- This creates .pgm (image) and .yaml (metadata) files
- Load map with 'rosrun map_server map_server filename'
- Map must be saved before loading
- Loaded map is used for robot navigation

Full Transcript

In ROS, saving and loading a map involves running specific commands. First, start the ROS environment with roscore. Then save the map using 'rosrun map_server map_saver -f my_map', which creates two files: my_map.pgm and my_map.yaml. The .pgm file holds the map image, and the .yaml file contains important metadata like resolution and origin. After saving, load the map with 'rosrun map_server map_server my_map'. This loads the map into ROS so the robot can use it for navigation. It is important to save the map before loading it, or loading will fail. The process ends when the robot uses the loaded map for localization and planning. This step-by-step flow ensures the map data is preserved and reused effectively.

Practice

1. What is the primary purpose of using map_saver in ROS?

easy

A. To control the robot's movement based on the map

B. To load a previously saved map into the robot's system

C. To save the current map of the robot's environment to files

D. To visualize the robot's sensor data in real-time

Solution

1. Step 1: Understand the role of map_saver

   map_saver is a ROS tool used to save the map data the robot has explored.

2. Step 2: Differentiate from map_server

   map_server is used to load maps, not save them.

3. Final Answer:

   To save the current map of the robot's environment to files -> Option C

4. Quick Check:

   Saving maps = map_saver [OK]

Hint: Remember: saver saves, server loads maps [OK]

Common Mistakes:

• Confusing map_saver with map_server
• Thinking map_saver controls robot movement
• Assuming map_saver visualizes sensor data

2. Which command correctly saves a map in ROS using map_saver?

easy

A. rosrun map_saver map_server -f my_map

B. rosrun map_saver save_map -o my_map

C. roslaunch map_saver save_map.launch

D. rosrun map_server map_saver -f my_map

Solution

1. Step 1: Recall the correct command syntax

   The correct command to save a map is rosrun map_server map_saver -f filename.

2. Step 2: Check each option

   rosrun map_server map_saver -f my_map matches the correct syntax. The other options have incorrect package names, flags, or commands.

3. Final Answer:

   rosrun map_server map_saver -f my_map -> Option D

4. Quick Check:

   Correct save command = rosrun map_server map_saver -f my_map [OK]

Hint: Use rosrun map_server map_saver -f filename to save [OK]

Common Mistakes:

• Swapping map_saver and map_server in command
• Using wrong flags like -o instead of -f
• Using roslaunch instead of rosrun for map_saver

3. Given the following command:

rosrun map_server map_saver -f office_map

What files will be created after running this command?

medium

A. office_map.pgm and office_map.yaml

B. office_map.txt and office_map.yaml

C. office_map.png and office_map.json

D. office_map.map and office_map.config

Solution

1. Step 1: Understand map_saver output files

   map_saver saves maps as an image file (.pgm) and a YAML file (.yaml) describing the map metadata.

2. Step 2: Match file extensions to options

   office_map.pgm and office_map.yaml correctly lists .pgm and .yaml files. Other options list incorrect file types.

3. Final Answer:

   office_map.pgm and office_map.yaml -> Option A

4. Quick Check:

   Map files = .pgm + .yaml [OK]

Hint: Map saves as .pgm image and .yaml metadata files [OK]

Common Mistakes:

• Expecting .png or .json files instead of .pgm and .yaml
• Confusing .txt or .map extensions with map files
• Thinking map_saver creates only one file

4. You try to load a saved map using rosrun map_server map_server office_map.yaml but get an error saying the map file is missing. What is the most likely cause?

medium

A. The map_server command requires a .pgm file, not a YAML file

B. The .pgm image file is missing or not in the same folder as the YAML file

C. The YAML file is corrupted and cannot be read

D. The robot's sensors are not turned on

Solution

1. Step 1: Understand map_server loading requirements

   map_server loads the YAML file which references the .pgm image file. Both must be present in the same folder.

2. Step 2: Analyze the error cause

   If the .pgm file is missing, map_server cannot load the map, causing the error.

3. Final Answer:

   The .pgm image file is missing or not in the same folder as the YAML file -> Option B

4. Quick Check:

   Missing .pgm file causes load error [OK]

Hint: YAML needs matching .pgm file in same folder to load [OK]

Common Mistakes:

• Trying to load only the .pgm file without YAML
• Assuming sensors affect map_server loading
• Confusing file corruption with missing files

5. You want to save a map and then load it later for robot navigation. Which sequence of commands correctly achieves this?

hard

A. rosrun map_server map_saver -f home_maprosrun map_server map_server home_map.yaml

B. rosrun map_saver map_server -f home_maprosrun map_server map_saver home_map.yaml

C. roslaunch map_saver save.launch -map home_maproslaunch map_server load.launch -map home_map

D. rosrun map_server map_server -f home_maprosrun map_server map_saver home_map.yaml

Solution

1. Step 1: Save the map using map_saver

   Use rosrun map_server map_saver -f home_map to save the map files.

2. Step 2: Load the saved map using map_server

   Use rosrun map_server map_server home_map.yaml to load the saved map for navigation.

3. Step 3: Verify command correctness

   rosrun map_server map_saver -f home_map
rosrun map_server map_server home_map.yaml correctly shows the save then load sequence. Other options mix commands or use incorrect syntax.

4. Final Answer:

   rosrun map_server map_saver -f home_map then rosrun map_server map_server home_map.yaml -> Option A

5. Quick Check:

   Save then load with map_saver and map_server [OK]

Hint: Save first with map_saver, then load with map_server [OK]

Common Mistakes:

• Mixing up map_saver and map_server commands
• Using roslaunch instead of rosrun incorrectly
• Trying to load before saving the map