Implement Localization Accuracy and Real-Time Metrics

Đang mở
#759 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
15/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
rust
Lĩnh vực
observability, performance

Hướng nghiên cứu

The issue names no files, tests or entry points, so start by finding the existing localization pipeline and its task scheduling code in the repository. Decide the measurement boundaries and clock mappings before adding any instrumentation, since the issue requires each metric to have a documented definition, unit and clock domain. Done means synthetic traces with known delays and deadline misses produce the expected metric values, and the summaries can be reproduced from machine-readable output. This is design-heavy work, so discuss the approach with maintainers before writing code.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Implement consistent instrumentation and reporting for localization accuracy, scheduling delay, deadline misses, end-to-end latency, and input data age in the integrated Awkernel localization pipeline. Provide reusable metrics for concurrent replay evaluation and subsequent robustness experiments.

Scope:

  • Define measurement boundaries and clock mappings for all metrics
  • Measure position and orientation errors against timestamp-aligned ground truth where available
  • Measure scheduling delay from task readiness to execution start, distinguishing it from input-release delay and dependency waiting
  • Detect deadline misses using explicitly defined release times, deadlines, and completion events
  • Measure per-scan latency from pipeline input availability to the associated NDT result
  • Track when NDT and gyro odometry measurements are incorporated into EKF outputs
  • Measure the age of each consumed input from its measurement timestamp to consumption time
  • Export per-event records and aggregated summaries

Acceptance criteria:

  • Each metric has a documented definition, unit, clock domain, and applicable task or output.
  • Trace identifiers associate scans, task executions, measurements, and outputs without relying solely on timestamp proximity.
  • EKF output latency and freshness are reported separately for relevant input streams rather than attributed to an arbitrary latest scan.
  • Deadline reports include miss counts, evaluated-job counts, miss ratios, and tardiness; dropped or unfinished jobs are reported separately.
  • Timing summaries include median, tail percentiles, and maximum observed values with sample counts.
  • Accuracy reports distinguish ground-truth errors from differences against a reference implementation.
  • Synthetic traces with known delays and deadline violations validate the metric calculations.
  • Instrumentation overhead is measured and reported.
  • Machine-readable results and analysis commands are sufficient to reproduce the summaries.

Out of scope:

Replay workload generation, changes to localization algorithms or scheduling policies, and formal worst-case timing guarantees.

Ngôn ngữ chính
Rust
Star
282
Fork
12
Merge trung bình
2 ngày 9 giờ
Pull request đã merge (30 ngày)
28

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của tier4/awkernel

Tất cả issue của tier4/awkernel

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.