multi-floor-mapping

Orchestrate per-floor occupancy grids, map switching, and AMCL re-localization for multi-floor navigation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Handle multi-floor mapping by orchestrating per-floor maps, floor transitions, and re-localization to maintain robust navigation across levels.

Core Features & Use Cases

  • Per-floor maps with a transition manager to load new maps on floor change
  • AMCL reinitialization, initial pose publishing and costmap clearing to minimize drift
  • Supports single map server or multiple map servers with per-floor configurations

Quick Start

Configure a per-floor map setup and start the Floor Transition Manager to enable automatic floor changes.

Frequently Asked Questions about multi-floor-mapping

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

FAQPage Schema
How do I handle multi-floor navigation and map switching in ROS2?

Multi-floor navigation in ROS2 requires orchestrating per-floor occupancy grids, map switching, and AMCL re-localization. A floor-transition manager loads new maps on floor change and clears costmaps to maintain robust navigation across levels.

What is the best way to manage AMCL re-localization during a floor transition?

AMCL re-localization during a floor transition requires reinitializing AMCL, publishing a new initial pose for the target level, and clearing the costmap. This minimizes positioning drift when the map server loads the new floor configuration.

Does Nav2 support automatic map switching for buildings with multiple levels?

Nav2 supports automatic map switching for multiple levels by using a transition manager. A clear floor-change trigger initiates the switch, loading the corresponding per-floor map YAML and updating the map server interface seamlessly.

Can I use a single map server for multifloor mapping, or do I need multiple?

Multifloor mapping supports both a single map server and multiple map servers. You can configure per-floor setups with distinct map YAMLs and initial poses, allowing the transition manager to load the correct map for each level.

Why does my robot lose its position when navigating to a different floor?

Robots lose position during floor changes if AMCL is not reinitialized and the costmap is not cleared. Reliable multi-floor navigation requires publishing a correct initial pose for the new floor map to prevent localization drift.

What do I need to configure before starting multifloor mapping in Nav2?

Before starting multifloor mapping in Nav2, you need a map server interface, per-floor map YAMLs, initial poses, a floor-transition manager, and a clear floor-change trigger to ensure proper occupancy grid switching and AMCL re-localization.