costmap-filters

Configure Nav2 costmap filters for keepout zones and speed adjustments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Costmap filters allow applying spatial masks to the Nav2 costmap to enforce keepout zones, regulate speeds in defined regions, and trigger behavior based on spatial regions without altering the base map.

Core Features & Use Cases

  • Keepout and speed-aware filtering: apply per-region rules to constrain movement and speed in specified areas.
  • Mask-driven behavior: use filter masks aligned to the navigation map to selectively affect costmap layers.
  • Use Case: keep robots away from hazardous zones or slow down in high-traffic corridors while preserving global navigation.

Quick Start

Enable a keepout or speed filter in your Nav2 costmap and verify the mask aligns with the map.

Frequently Asked Questions about costmap-filters

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

FAQPage Schema
How do I configure Nav2 costmap filters to create keepout zones?

To configure Nav2 costmap filters for keepout zones, use the CostmapFilterInfoServer and appropriate filter plugins to apply spatial masks. This selectively restricts robot navigation in hazardous areas without altering the base map.

Can I adjust robot speed in specific corridors using ROS2 navigation?

Yes, you can regulate robot speed in specific corridors using ROS2 navigation by applying costmap filters. Speed filter plugins use spatial masks aligned with the navigation map to enforce per-region speed adjustments in high-traffic areas.

What is a costmap filter mask in Nav2?

A costmap filter mask in Nav2 is a spatial overlay aligned to the navigation map. It selectively applies rules, such as keepout boundaries or speed limits, to the costmap layers to trigger behavior based on spatial regions.

How do I validate costmap filter mask alignment with the base map?

Validating costmap filter mask alignment with the base map involves checking the spatial overlay against the navigation map coordinates. Proper validation ensures the filter plugins consistently apply per-region rules like keepout zones and speed adjustments.

Does the order of Nav2 costmap filter plugins affect performance?

Yes, the order of Nav2 costmap filter plugins affects performance and behavior. Ensuring correct plugin ordering within the CostmapFilterInfoServer workflow guarantees consistent application of spatial masks across restricted corridors and lane preferences.

How do I apply lane preferences in ROS2 Nav2 without modifying the base map?

You apply lane preferences in ROS2 Nav2 without modifying the base map by using costmap filters. Spatial masks overlay the navigation map to selectively affect costmap layers, enforcing preferred routes while preserving global navigation capabilities.