Skip to content

feat(ui): redesign ARL flight deck and drone visualization - #309

Open
AryanXCode646 wants to merge 1 commit into
StellarResearch:mainfrom
AryanXCode646:feat/arl-flightdeck-visual-overhaul
Open

AryanXCode646 wants to merge 1 commit into
StellarResearch:mainfrom
AryanXCode646:feat/arl-flightdeck-visual-overhaul

Conversation

@AryanXCode646

Copy link
Copy Markdown
Contributor

Summary of Changes

This pull request delivers a comprehensive visual and technical overhaul of the AdaptiveRL platform, transitioning the project into a professional aerospace flight deck and autonomous drone simulation environment.

1. Browser Simulation Correctness (docs/js/simulation.js)

  • Fixed Progress Calculation Bug: Replaced the static pre-step distance subtraction with actual post-integration progress delta (distDelta = distBefore - distAfter), eliminating zero-progress reward anomalies.
  • Post-Step Goal & Collision Detection: Ensured goal arrival (distAfter <= TARGET_RADIUS) and obstacle/boundary collision checks evaluate the post-step state.
  • Semi-Implicit Euler Integration: Aligned kinematic integration, drag damping, and acceleration clamping directly with src/adaptive_rl/environments/drone.py.
  • Dynamic Scrubber & Reset: Implemented interactive historical trajectory inspection that preserves recorded flight paths; reset properly restores all kinematic states, meshes, and HUD telemetry.
  • Controls & Accessibility: Added 0.5x/1.0x/2.0x playback speed multipliers, camera recenter, keyboard shortcuts (Space, R, C), accessible WebGL fallback banner, and prefers-reduced-motion handling.
  • Scientific Disclosure: Explicitly labeled browser simulation as an illustrative potential-field guidance controller, distinguishing it from local PyTorch policy inference.

2. High-Fidelity 3D Drone Graphics (docs/js/simulation.js & src/adaptive_rl/gui/visualizer.py)

  • Detailed Quadrotor Airframe: Procedurally modeled layered carbon fuselage, four arms in X-configuration ( = L/\sqrt{2}$ matching 6-DOF coordinate conventions), four motor bells, hubs, and visible dual-blade propellers.
  • Dynamic Rotor Animation: Propeller blades rotate with alternating CW/CCW directions during active simulation playback.
  • Landing Gear & Sensor Assembly: Added four carbon landing struts and a forward optical sensor pod with heading indicators (+X nose).
  • Front/Rear Visual Identification: Front arms/hubs highlighted with aviation red/amber accents; rear arms highlighted with aerospace cyan/blue accents.
  • Color-Coded 16-Ray LiDAR: Ray beams dynamically colorize based on clearance (Cyan > 10m, Amber 4–10m, Crimson < 4m) with real-time contact hit markers on obstacles and walls.

3. ARL Website Redesign (docs/index.html, docs/css/style.css)

  • Aerospace Visual Identity: Redesigned GitHub Pages site with deep graphite surfaces (#050811), technical grid details, restrained cyan/blue lighting, and responsive typography.
  • 12-Section Architecture:
    1. Navigation & Live System Status
    2. Hero with Large Interactive 3D Flight Arena
    3. Real-Time Physical Telemetry Strip
    4. 3-DOF vs. 6-DOF Dual Dynamics Matrix
    5. End-to-End RL Control Loop & Architecture
    6. Interactive 2D/3D LiDAR Sensor Inspector
    7. Verified Benchmark Data from Real Artifacts
    8. Experiment Reproducibility & Provenance
    9. Streamlit Flight Deck Overview
    10. Linux Quick-Start Installation
    11. Technical Limitations & Safety Scope
    12. Open Science & Repository Documentation
  • Executive Briefing Mode: Upgraded presentation modal with 10 structured slides.

4. Streamlit Flight Deck Application (app.py)

  • Grouped Telemetry Strip: Grouped disparate metrics into Navigation, Attitude, Kinematics, Perception, and Return.
  • New Research Evidence Dashboard (Tab 5): Real-time SHA-256 cryptographic verification of model checkpoints against adaptive_rl.manifest JSON files; displays verified badges only on exact matches.
  • Dual Dynamics Playback: Full toggle between 6-DOF rigid-body dynamics (quaternion attitude, Euler angles) and 3-DOF point-mass kinematics.

5. Documentation & Tests

  • Created docs/GUI.md comprehensive flight deck documentation.
  • Synchronized README.md, docs/ARCHITECTURE.md, docs/ENVIRONMENT.md, and docs/ENVIRONMENT_6DOF.md.
  • Added tests/test_flightdeck_visuals.py covering 3D geometry, LiDAR contacts, cryptographic integrity checks, and simulation contract invariants.
  • Full test suite passed: 382/382 tests passing (66.92s).
  • Quality gates passed: Ruff check, Ruff format, and Mypy passed with 0 errors.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant