path-tracking-metrics

Compute cross-track error, heading error, and path length ratio from ROS 2 bag data.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Measures and interprets path-tracking performance for navigation systems, enabling quantitative evaluation of cross-track error, heading alignment, and path efficiency.

Core Features & Use Cases

  • Compute cross-track error, heading error, and path length ratio from /odom and /plan data.
  • Provide an analysis script to output mean, max, and statistics for these metrics, plus guidance for tuning controllers.
  • Use in offline troubleshooting, patrol planning, and continuous monitoring to detect drift or degradation.

Quick Start

Run the path-tracking-metrics analysis script on a rosbag containing /odom and /plan data to output the metrics.

Frequently Asked Questions about path-tracking-metrics

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

FAQPage Schema
How do I calculate cross-track error and heading error from ROS 2 bag data?

To calculate cross-track error and heading error from ROS 2 bag data, run an offline analysis script on rosbag files containing /odom and /plan data streams to quantify navigation path-tracking fidelity.

What metrics are needed to evaluate ROS 2 navigation path-tracking quality?

Evaluating ROS 2 navigation path-tracking quality requires metrics like cross-track error, heading error, path length ratio, and velocity statistics computed from odometry, plan, local_plan, cmd_vel, and tf data streams.

Can I use path-tracking analysis scripts for outdoor ROS 2 patrols and simulated scenarios?

Yes, path-tracking analysis scripts apply to offline analysis for indoor and outdoor ROS 2 patrols, vehicle datasets, and simulated scenarios where path following is critical.

How do I troubleshoot ROS 2 navigation drift using rosbag2 recordings?

To troubleshoot ROS 2 navigation drift using rosbag2, analyze recorded odometry and plan data to compute mean, max, and statistics for tracking metrics, detecting degradation and guiding controller tuning.

Do I need local_plan and cmd_vel topics to measure path length ratio in ROS 2?

Yes, measuring path length ratio and velocity statistics requires local_plan and cmd_vel topics alongside odometry, plan, and tf data streams recorded in your ROS 2 bag.