Fox v1.1 Release Walkthrough

This release marks a major architectural shift from a monolithic script to a modular, stage-based pipeline, while simultaneously achieving full feature parity with the high-fidelity test_shenron.py radar testbench.

🚀 Key Achievements

1. Unified Radar Physics & Visualization

Single Source of Truth: All radar plotting and post-processing logic is now centralized in scripts/ISOLATE/sim_radar_utils/plots.py.
FastHeatmapEngine: Migrated the production pipeline to the stateful rendering engine, resulting in consistent dB scaling and improved performance.
Dual RA Stream: Range-Azimuth (RA) visualization now produces both a Static (absolute magnitude) and Dynamic (peak-tracking) stream for Foxglove.
3D FOV Frustums: Added hardware-accurate 3D frustum wireframes for all radar types (AWRL1432 and RadarBook).

2. Modular Stage-Based Pipeline

PipelineManager: Orchestrates the execution of discrete stages: Simulation → Shenron → MCAP → Video.
Feature Parity: Ported advanced telemetry flattening and metrology math from the testbench to the production exporter.
Selective Execution: New CLI flags allow running only specific stages (e.g., --only-mcap to re-process existing data).

3. Robustness & Portability

Pathlib Integration: Replaced brittle os.path joins with robust Pathlib logic in all pipeline stages and the orchestrator.
Stop Flag Detection: Fixed a path bug in the stop flag detection to ensure graceful simulation shutdown works reliably across different working directories.
Hardware Persistence: Added radar_specs.json generation to save hardware constants (carrier frequency, velocity limits) during synthesis for downstream visualization.

🛠️ Verification Results

Component	Status	Verification Detail
Dashboard	✅	Version bumped to v1.1; scenario list and status polling verified.
SimStage	✅	Verified ego spawn, weather application, and `stop.flag` path resolution.
ShenronStage	✅	Verified `sys.path` injection and telemetry event emission.
McapStage	✅	Verified `FastHeatmapEngine` initialization and `ISOLATE` path handling.
Telemetry	✅	Verified flattened schema for Foxglove Plot panel compatibility.

📦 File Audit Summary

src/main.py: Refactored to thin CLI wrapper for PipelineManager.
src/pipeline/*: New core architecture for stage management.
src/recorder.py: Decoupled from physics logic; focused on raw capture.
src/processing/physics.py: Reusable physics layer for radial velocity and ADAS metrics.
scripts/data_to_mcap.py: Upgraded to v1.1 with testbench parity and 3D diagnostics.
dashboard/templates/index.html: UI updated to reflect v1.1.

Generated by Antigravity AI | Fox v1.1 "Ares" Release

2.8 KiB Raw Blame History