A GUI tool for editing ROS map files in PGM format. This tool allows you to view and modify occupancy grid maps used in ROS (Robot Operating System) navigation.
- Load and display PGM map files used in ROS
- Edit map cells (occupied, free, unknown)
- Zoom in/out for detailed editing
- Minimap for navigation in large maps
- Automatically saves changes on exit
- ☒ BOX Select
ROS Map Editor
- ☒ Line Select
ROS Map Editor
- ☐ Polygon Select
- ☐ Rapidly Loading and Editing
pip install ros-map-editorgit clone https://github.com/sujit-168/ros_map_editor.git -b main
cd ros_map_editor
pip install -e .ros-map-editor path/to/your/mapor simply:
python3 ros_map_editor/main.py path/to/your/mapThe tool will automatically look for the corresponding YAML file (map.yaml) in the same directory.
- Zoom: Select zoom level from the dropdown menu
- Color: Choose what to draw:
- Occupied: Mark cells as obstacles (black)
- Free: Mark cells as free space (white)
- Unknown: Mark cells as unknown (gray)
- Alternate: Cycle through states with each click
- Minimap: Shows your current position in the map with a red rectangle
- Drawing: Click or drag to modify cells
The tool works with standard ROS map files:
- A PGM image file containing the occupancy grid
- A YAML file with metadata (resolution, origin, thresholds)
Example YAML file:
image: map.pgm
resolution: 0.050000
origin: [-10.000000, -10.000000, 0.000000]
negate: 0
occupied_thresh: 0.65
free_thresh: 0.196- Python 3.6+
- PyQt5
- Pillow (PIL)
- PyYAML
Public domain
Contributions are welcome! Please feel free to submit a Pull Request.