docs/adr/ADR-171-swarm-benchmarking-evaluation-methodology.md
| Field | Value |
|---|---|
| Status | Accepted (peer-reviewed 2026-05-30) |
| Date | 2026-05-30 |
| Deciders | ruv |
| Relates to | ADR-148 (ruview-swarm), ADR-147 (OccWorld), ADR-146 (RF encoder), ADR-028 (witness) |
Companion to ADR-148. ADR-148 shipped the swarm and 5 criterion micro-benchmarks plus a
SotaComparisonagainst Wi2SAR. This ADR defines how we evaluate the swarm rigorously — what metrics, what statistics, what baselines, and an honest account of which external leaderboards do and do not apply.
ADR-148's ruview-swarm reports performance via five criterion micro-benchmarks and a
single SotaComparison (localization 1.732 m vs Wi2SAR 5 m; coverage ~223 s vs 810 s).
These numbers are internally valid but insufficient as scientific claims:
estimate_coverage_time_secs()), not an
episode rollout.We need a defined, reproducible evaluation methodology before any "beats SOTA" claim can survive external review, and an honest position on external leaderboards.
Adopt a two-tier evaluation methodology:
Do not claim leaderboard standing — no public leaderboard accepts drone-swarm CSI-SAR submissions. Comparisons to Wi2SAR are paper-to-paper, labeled as such, acknowledging the sensing-modality difference (RSS bearing vs CSI multi-view fusion).
There is no public, externally-administered leaderboard that accepts a drone-swarm, CSI-based, multi-view SAR system. This is a research niche; comparison is paper-to-paper. The adjacent options and their fit:
| Benchmark / Leaderboard | Domain | Live submission? | Fit for ruview-swarm |
|---|---|---|---|
| Wi2SAR (arxiv 2604.09115) | Drone WiFi SAR | No (paper) | Direct baseline — paper-to-paper only; RSS bearing ≠ CSI fusion |
| MARL4DRP (Springer 2023) | Drone routing MARL | No | Closest drone-MARL benchmark; would need a routing→coverage adapter |
| CSI-Bench (NeurIPS 2025) | Static WiFi sensing | Splits + paper baselines | Adjacent (localization task) but no moving-sensor/multi-view fusion |
| SMAC / SMACv2 | StarCraft cooperative MARL | No live LB | Structural analogy (CTDE) only; combat task, not coverage |
| PettingZoo MPE (Simple Spread) | 2D cooperative particles | No | Cheap MARL correctness check, no physics/CSI |
| Melting Pot | Social-dynamics MARL | Closed (NeurIPS '24) | Not applicable |
| MAMuJoCo / Hanabi / GRF / Overcooked | Various cooperative MARL | No live LB | Not applicable |
| OmniDrones / gym-pybullet-drones / Pegasus | Drone-control sim platforms | No (platforms) | Training infrastructure, not leaderboards; no CSI layer |
Conclusion: We will (a) keep Wi2SAR as the cited paper baseline, (b) optionally build a MARL4DRP/MPE adapter to post a recognized cooperative-MARL number (tangential to SAR), and (c) not represent any internal number as a leaderboard placement.
| Metric | Definition | Reporting |
|---|---|---|
| Localization CEP50 | Median horizontal error, fused victim position vs ground truth | m, 95% CI |
| Localization CEP95 | 95th-percentile horizontal error | m |
| GDOP | Geometric Dilution of Precision of the contributing-drone constellation at detection time | dimensionless (tracked per detection) |
| Coverage rate @ T | Fraction of area scanned ≥1× within T=240 s | %, 95% CI |
| Coverage time to 95% | Time to scan 95% of bounded area | s, mean ± CI |
| Time-to-first-detection | Mission start → first confident detection (conf > 0.85) | s, 95% CI |
| Detection rate | P(detected | victim present) per mission | %, 95% CI |
| False-alarm rate | P(confident detection | no victim) | %, 95% CI |
| Collision rate | Collisions (d < 1.5 m) per mission | count/mission |
| Overlap ratio | Fraction of path re-covering scanned cells | % |
| Metric | Definition |
|---|---|
| IQM episodic return | Interquartile mean over 10 seeds × 50 eval episodes (Agarwal 2021) |
| Probability of improvement | P(MAPPO return > IPPO return) on a random episode |
| Optimality gap | Expected gap to a defined reference performance |
| Performance profile | Fraction of (seed, episode) with localization error < τ, plotted vs τ ∈ [0,10] m |
| Sample efficiency | Return vs training steps (curve, not point) |
Retained from ADR-148, labeled as compute latency, not quality:
marl_actor_inference 3.3 µs · rrt_apf_100iter 43 µs · multiview_fusion_3drones 54 ns ·
demo_coverage_estimate 100 ps · ppo_update_64transitions 248 µs. Purpose: prove the
control loop has no compute bottleneck (all ≪ the 10 ms / 100 Hz budget) and gate
performance regressions. They are not evidence of policy or localization quality.
| Requirement | Standard adopted |
|---|---|
| Seeds per condition | ≥10 training runs from distinct seeds |
| Evaluation episodes | 50 fixed, versioned episodes per trained policy (10 victim layouts × 5 CSI-noise levels) |
| Aggregate metric | IQM (not mean, not median) + performance profiles |
| Confidence intervals | 95% stratified bootstrap, 1,000 resamples |
| Baselines (≥3) | Random walk (lower bound), Boustrophedon+manual-triangulation (heuristic), IPPO (no shared critic) |
| Reproducibility | Versioned YAML config (drone count, area, victims, CSI σ amplitude / κ phase, wind, packet loss) + all seeds committed with results |
Rationale: Henderson et al. (2018) found ≤5-seed point estimates flip rankings; Agarwal et
al. (2021, NeurIPS Outstanding Paper) show IQM needs ~10 runs for the statistical power that
the median needs ~200 runs for; Gorsane et al. (2022) made ≥10 seeds + IQM + stratified CIs
the cooperative-MARL standard. rliable (google-research/rliable) is the reference impl.
evals/)A new evaluation harness (separate from criterion micro-benchmarks):
Date.now()/unseeded RNG).evals/RESULTS.md: a reproducible internal leaderboard ranking
our 6 flight patterns × learning patterns on the SAR metrics, plus the Wi2SAR paper row.This RESULTS.md is the real, defensible "leaderboard" for this system — patterns ranked
against each other and the cited baseline, reproducibly, with CIs.
The full matrix is 10 seeds × 50 episodes × ≥4 conditions = ≥2,000 rollouts per policy. Running each rollout against the OccWorld 3D prior (ADR-147, ~375 ms/inference) would melt the L4 / RTX 5080 budget. Split evaluation into two stages:
Stage 1 is CI-runnable today; Stage 2 requires the Gazebo/PX4 SITL bring-up (follow-on).
The config generator systematically varies the two CSI noise parameters:
Sweeping (σ, κ) isolates the exact environmental threshold where CrossViewpointAttention
(ADR-016) drops out of its coherence gate (coherence_gate.rs Accept → PredictOnly/Reject,
ADR-135). This finds the operating envelope, not just a single-point accuracy.
Localization accuracy is meaningless without the constellation geometry that produced it. The harness records GDOP per detection: 3 drones in a ~120° constellation give the √3 ≈ 1.73× CRLB improvement; 3 collinear drones degrade toward the single-view Cramer-Rao limit (~2.9 m). Reporting localization error stratified by GDOP band prevents the headline number from being a best-case geometric artifact.
| Claim | Grade | Why |
|---|---|---|
| criterion latencies (3.3 µs / 43 µs / 54 ns / 248 µs) | High | Deterministic compute, hardware-specific, reproducible |
| Wi2SAR baseline (5 m, 160k m²/13.5 min) | High | Published field trial, open source |
| 1.732 m 3-view localization | Low–Medium | Single synthetic geometry; no noise distribution; CRLB predicts ~2.9 m for N=3 |
| 223 s 4-drone coverage | Low | Analytic estimate, not an episode rollout |
| "beats SOTA" | Directional only | Valid as paper-to-paper direction; not leaderboard, not multi-seed |
The √N multi-view scaling claim is theoretically sound (CRLB: σ ∝ 1/√(N·SNR); N=3 → √3 ≈ 1.73× improvement), but the measured 1.732 m must be reproduced over a victim-position and noise distribution before it is defensible.
RESULTS.md internal leaderboard ranks the 6 flight × 4 learning patterns fairly.evals/ harness + RESULTS.md generator.Compiled by ruflo-goals:deep-researcher (2026-05-30). Full landscape in the agent record.
MARL evaluation rigor
rliableCooperative-MARL benchmarks
Drone-sim platforms
SAR / coverage / CSI sensing
Tooling
ADR authored with research support from ruflo-goals:deep-researcher (2026-05-30).
Companion to ADR-148. Defines the evaluation methodology that the ADR-148 headline
numbers must satisfy before being republished as defensible claims.