From 3a12ca6765e8b2ad7fcec4f4546f08311c1ba5f0 Mon Sep 17 00:00:00 2001 From: rakadu1 Date: Wed, 11 Mar 2026 17:22:10 +0530 Subject: [PATCH] chore: update internal paths for documentation moved to annex/ --- steps/Final_Changelog.html | 183 -------------------- steps/GEM_Changes.html | 134 --------------- steps/GPT_changes.html | 194 ---------------------- steps/{ => annex}/Changelog.html | 0 steps/{ => annex}/GIT_Changes.txt | Bin steps/{ => annex}/Improvements.txt | 0 steps/{ => annex}/User_Manual.html | 0 steps/{ => annex}/code-base-overview.html | 7 +- steps/{ => annex}/shortcuts.html | 0 steps/index.html | 21 ++- steps/{ => intel}/GEMINI.md | 0 steps/{ => intel}/context.md | 0 steps/{ => intel}/readme.md | 11 +- 13 files changed, 20 insertions(+), 530 deletions(-) delete mode 100644 steps/Final_Changelog.html delete mode 100644 steps/GEM_Changes.html delete mode 100644 steps/GPT_changes.html rename steps/{ => annex}/Changelog.html (100%) rename steps/{ => annex}/GIT_Changes.txt (100%) rename steps/{ => annex}/Improvements.txt (100%) rename steps/{ => annex}/User_Manual.html (100%) rename steps/{ => annex}/code-base-overview.html (99%) rename steps/{ => annex}/shortcuts.html (100%) rename steps/{ => intel}/GEMINI.md (100%) rename steps/{ => intel}/context.md (100%) rename steps/{ => intel}/readme.md (96%) diff --git a/steps/Final_Changelog.html b/steps/Final_Changelog.html deleted file mode 100644 index 6ead04d..0000000 --- a/steps/Final_Changelog.html +++ /dev/null @@ -1,183 +0,0 @@ - - - - - - ARAS Evolution: V2 to V3 Comprehensive Changelog - - - - - - -
-
- Major Release - Baseline: e1b8aac (V2) | Current: 16f7736 (V3) -
-

- ARAS Visualizer: Version 3 -

-

- Version 3 represents a major architectural milestone. The application evolved from a functional visualization prototype into a robust, modular, performance-optimized, and architecturally documented professional tool. -

-
- -
- - -
-
-
⚡
-

1. Sync Engine Rearchitecture

-
-

Redesigned to eliminate drift, stutter, and race conditions.

-
    -
  • • Migration to videoFrameCallback for deterministic sync.
    • -
  • • Hybrid video-radar synchronization architecture.
    • -
  • • Centralized offset handling logic and persistence.
    • -
  • • Drift Cascade Lockdown: Prevents seek-loops on low-end hardware.
    • -
-
- - -
-
-
📂
-

2. File Loading & Caching

-
-

Complete modularization of the file processing pipeline.

-
    -
  • • Extraction of file handling into dedicated fileLoader.js.
    • -
  • • Incremental JSON & video loading support.
    • -
  • • Promise-based IndexedDB initialization (Race condition fixes).
    • -
  • • Non-blocking "fire-and-forget" caching logic.
    • -
-
- - -
-
-
🚀
-

3. Performance Optimization

-
-

Rendering refactored for memory stability and frame-rate consistency.

-
    -
  • • Removed layout-thrashing innerHTML calls in draw loops.
    • -
  • • Canvas optimization to avoid heap allocations and GC pressure.
    • -
  • • 20% total performance gain via smart throttling and debouncing.
    • -
  • • FPS counter stabilization with warmup and smoothing logic.
    • -
-
- - -
-
-
🧠
-

4. Advanced Visualization

-
-

Intelligent data interpretation and professional UI interactions.

-
    -
  • • Smart Labeling: Greedy collision resolution for track markers.
    • -
  • • Spectral Density: Speed graph coloring based on track count.
    • -
  • • Interactive seeking and high-speed scrubbing in speed graph.
    • -
  • • Dynamic range slider (20m–200m) with auto-scaling ROI.
    • -
-
- - -
-
-
🔭
-

5. Zoom & God Mode

-
-
    -
  • • Inertial Tracking: Exponential mouse smoothing (60Hz/144Hz agnostic).
    • -
  • • Inverse zoom logic and boundary-aware tooltip constraints.
    • -
  • • Shift-Key seeking: Integrated timeline scrubbing within radar canvas.
    • -
  • • Relative distance square optimization to eliminate hover jitter.
    • -
-
- - -
-
-
🗺️
-

6. Living Documentation

-
-
    -
  • • Interactive Codebase Overview: Integrated 3D-styled navigation.
    • -
  • • Color-coded architecture explorer (Core, Sync, UI, P5).
    • -
  • • Local PrismJS integration for high-perf syntax highlighting.
    • -
  • • Mini-map docking navigation system for architectural modules.
    • -
-
- - -
-
-
🛠️
-

7. UX & Modal System

-
-
    -
  • • First-run detection with automated User Guide onboarding.
    • -
  • • Standalone Keyboard Shortcut reference modal.
    • -
  • • Refactored header navigation with theme-aware icons.
    • -
  • • Internet-free operation (Removed Google Fonts dependency).
    • -
-
- - -
-
-
📊
-

8. Data Explorer

-
-
    -
  • • Draggable and resizable side-panel for granular inspection.
    • -
  • • Bi-directional timeline synchronization.
    • -
  • • Expanded metadata for tracked objects (Risk, State, Sign).
    • -
  • • Throttled data updates to maintain rendering performance.
    • -
-
- - -
-

9 & 10. Stability & Infrastructure

-
-
    -
  • • Guards against division-by-zero in SNR mapping.
    • -
  • • Fixed tooltip Y-jitter bug in drawUtils.js.
    • -
  • • Standardized p.deltaTime across all browser engines.
    • -
  • • Dark mode refinements for raw point visibility.
    • -
-
    -
  • • Decoupled UI logic from the main.js orchestrator.
    • -
  • • Isolated keyboard shortcuts for improved maintainability.
    • -
  • • Unit test suite expanded for utils and parsers.
    • -
  • • Comprehensive Context and README documentation updates.
    • -
-
-
- -
- - - - - \ No newline at end of file diff --git a/steps/GEM_Changes.html b/steps/GEM_Changes.html deleted file mode 100644 index 998b39e..0000000 --- a/steps/GEM_Changes.html +++ /dev/null @@ -1,134 +0,0 @@ - - - - - - Version 3.0 Changelog - - - - - -
- -
-

Changelog v3.0

-

A comprehensive overview of architectural overhauls, performance optimizations, and new features introduced in the latest release.

-
- -
- -
-

- - Major Changes -

- -
- -
-

Hybrid Sync & Playback Engine

-

The synchronization architecture between video and radar data was completely rewritten to eliminate stutter and ensure 100% solid logic.

-
    -
  • Moved updateFrame directly into the videoframecallback for display refresh rate synchronization.
    • -
  • Implemented a "Resync Drift Cascade Lockdown" (circuit breaker) to prevent infinite loop freezes on low-end hardware or when multiple tabs are open.
    • -
  • Added frame-rate independent smoothing for UI and sketches.
    • -
  • Centralized timeline slider, manual offset, and play/stop/pause logic into a dedicated sync.js module.
    • -
-
- -
-

Modular File Loading & Offline Support

-

Monolithic application files were broken down, and the software was adapted to work entirely offline.

-
    -
  • Extracted file handling into src/fileLoader.js, supporting incremental loading (replacing individual files without breaking app state).
    • -
  • Resolved IndexedDB race conditions and startup crashes by ensuring metadata is extracted before parsing visualization data.
    • -
  • Removed Google Fonts dependency and implemented robust fallback logic for local JS libraries, enabling full offline capability.
    • -
  • Corrected caching key usage to ensure auto-reloading from IndexedDB works seamlessly.
    • -
-
- -
-

Performance & Memory Optimizations

-

Significant improvements to the rendering pipeline to reduce memory allocation and boost framerates.

-
    -
  • Resolved major heap memory issues by iterating through data and drawing rectangles directly to the canvas, changing ctx.fillStyle only once per column.
    • -
  • Improved FPS counter stability with a warmup period to prevent erroneous spikes during new file loads.
    • -
  • Removed unnecessary animation loop calls (e.g., drawing axes every frame) and reduced text content updates for a 20%+ performance boost.
    • -
  • Throttled the MATLAB-style Data Explorer updates to prevent unnecessary function calls when closed.
    • -
-
- -
-

Living Documentation & Analytical Tools

-

Introduced powerful new ways to explore both the application data and the codebase itself.

-
    -
  • Living Documentation: Added an interactive codebase overview with a visual 3D-styled navigation map and PrismJS syntax highlighting.
    • -
  • Data Explorer: Added a draggable, resizable MATLAB-style data explorer with timeline sync and track information (launched via 'i' key).
    • -
  • Speed Graph: Implemented drag-to-seek, click-to-seek, and hover tooltips for CAN/Ego speeds.
    • -
  • Added an Inter-Frame Timing (IFT) graph with dynamic scaling animations.
    • -
-
- -
-
- -
-

- - Minor Changes & UX Polish -

- -
-
- -
-

User Interface

-
    -
  • Added vertical range slider (20m-200m) to adjust RADAR_Y_MAX dynamically.
    • -
  • Double-click reset functionality added to range sliders.
    • -
  • Implemented an auto-loading Quick Start Guide modal on the first session launch.
    • -
  • Refined radar-info-overlay to match plot width and center text.
    • -
  • Added theme-aware color logic for raw point clouds in dark mode.
    • -
  • Removed redundant 'scale' and 'absolute time' metrics from persistent overlays.
    • -
-
- -
-

Zoom & God Mode

-
    -
  • Implemented smooth mouse tracking for the zoom tooltip.
    • -
  • Added Inverse Zoom Logic.
    • -
  • Constrained God Mode tooltips to remain inside the bounding sketch box.
    • -
  • Fixed hover detection bugs during scroll-zoom interactions.
    • -
  • Switched to relative distance squares to reduce computational overhead and initial hover jitter.
    • -
-
- -
-

Visuals & Inputs

-
    -
  • Added vehicle dimensions visualization and enhanced track risk coloring.
    • -
  • Added state identifiers directly beside TTC markers.
    • -
  • Fixed visibility toggle for "Confirmed ONLY" tracks.
    • -
  • New keyboard shortcuts: Arrow keys (navigation), Shift key (God Mode activation).
    • -
  • Isolated keyboard shortcut logic to prevent input conflicts.
    • -
  • Video player mute defaults removed; standard controls option added.
    • -
-
- -
-
-
- -
- -
- Generated from git commit history. -
-
- - - \ No newline at end of file diff --git a/steps/GPT_changes.html b/steps/GPT_changes.html deleted file mode 100644 index 865ab4d..0000000 --- a/steps/GPT_changes.html +++ /dev/null @@ -1,194 +0,0 @@ - - - - -Changelog – Version 2 to Version 3 - - - - - -

Version 3 – Comprehensive Changelog

-

Release Scope: Major architectural overhaul, performance optimization, synchronization stability, enhanced visualization intelligence, and UX refinement.

- - -

1. Sync Engine Rearchitecture (Major)

-
-

The playback and synchronization system was completely redesigned to eliminate drift, stutter, and race conditions.

- -

Key Enhancements:

- - -

Impact: Playback engine is now deterministic, stable under low-end hardware, and resilient against multi-tab load conditions.

-
- - -

2. File Loading & Caching Overhaul (Major)

-
-

Complete modularization of file loading pipeline.

- -

Improvements:

- - -

Impact: Eliminated startup crashes, resolved NaN timestamp errors, improved reload time, and increased system robustness.

-
- - -

3. Performance Optimization Initiative (Major)

-
-

Large-scale performance refactoring across rendering and DOM layers.

- -

Optimizations:

- - -

Impact: Significant memory stability improvement and smoother animation loops.

-
- - -

4. Advanced Visualization & UX Enhancements (Major)

-
-

Visualization layer significantly upgraded.

- -

Enhancements:

- - -

Impact: Visualization now supports intelligent data interpretation and professional-grade interaction behavior.

-
- - -

5. Zoom & God Mode Enhancements (Major)

-
- - -

Impact: Enhanced inspection capability for dense radar scenes with stable UX behavior.

-
- - -

6. In-App Documentation & Architectural Map (Major)

-
- - -

Impact: Application now self-documents architecture, accelerating onboarding and internal knowledge transfer.

-
- - -

7. User Guide & Modal System (Major)

-
- -
- - -

8. Data Explorer Enhancements (Major)

-
- -
- - -

9. Stability & Bug Fixes (Minor)

-
- -
- - -

10. Infrastructure & Refactoring (Minor)

-
- -
- - -

Summary of Version 3

-

-Version 3 represents a major architectural milestone. The application evolved from a functional visualization prototype into a robust, modular, performance-optimized, and architecturally documented professional tool. -

- - - -

Overall Classification: Major Release – Architectural & Performance Upgrade

- - - \ No newline at end of file diff --git a/steps/Changelog.html b/steps/annex/Changelog.html similarity index 100% rename from steps/Changelog.html rename to steps/annex/Changelog.html diff --git a/steps/GIT_Changes.txt b/steps/annex/GIT_Changes.txt similarity index 100% rename from steps/GIT_Changes.txt rename to steps/annex/GIT_Changes.txt diff --git a/steps/Improvements.txt b/steps/annex/Improvements.txt similarity index 100% rename from steps/Improvements.txt rename to steps/annex/Improvements.txt diff --git a/steps/User_Manual.html b/steps/annex/User_Manual.html similarity index 100% rename from steps/User_Manual.html rename to steps/annex/User_Manual.html diff --git a/steps/code-base-overview.html b/steps/annex/code-base-overview.html similarity index 99% rename from steps/code-base-overview.html rename to steps/annex/code-base-overview.html index b3e2b80..6a9b58f 100644 --- a/steps/code-base-overview.html +++ b/steps/annex/code-base-overview.html @@ -8,7 +8,7 @@ - + @@ -1297,7 +1297,7 @@ - +