How ujjwal-qubit/run_time_terror works
LumiTrack is a virtual-camera tracking testbed and algorithm evaluation platform. Its main workflow configures a simulation or MP4 run, produces observed frames, runs a tracking algorithm, optionally steers the virtual PTZ camera, and records benchmark metrics and results. The README documents the tracking pipeline, ground-truth firewall, and two benchmark modes; sampled source confirms controller orchestration, disturbance processing, detection, PTZ, metrics, and API behavior. Some subsystem links are omitted where their callers were not shown.
Main entry points: app_controller.py Application Controller · benchmark_manager.py Benchmark Manager · baseline_tracker.py Baseline Tracker · server.py REST and WebSocket API
Components 25
User Interfaces
- Web Frontend
frontend/src/App.tsx - API Client
frontend/src/api/client.ts - REST and WebSocket API
src/api/server.py - Desktop GUI
src/app/gui/main_window.py - CLI Entry
src/main.py - Visualization
src/app/visualization_engine.py - Results Views
frontend/src/components/results/ResultsPage.tsx
Run Orchestration
- Application Controller
src/app/app_controller.py - Configuration
src/config/config_manager.py - Scenario Manager
src/config/scenario_manager.py
Frame Sources
- Simulation World
src/simulation/scene_manager.py - Target Motion
src/simulation/target_manager.py - Disturbance Engine
src/simulation/disturbance_engine.py - Simulation and MP4 Frames
src/frame - Ground Truth
src/simulation/ground_truth_provider.py
Tracking and Control
- Algorithm Plugins
src/plugins/loader.py - Baseline Tracker
src/plugins/algorithms/baseline_tracker/baseline_tracker.py - Beacon Detection
src/tracker/detection_engine.py - Temporal Tracking
src/tracker/temporal_tracker.py - PTZ Control
src/control/ptz_controller.py
Evaluation and Results
- Benchmark Manager
src/evaluation/benchmark_manager.py - AI Scenario Workflow
src/evaluation/ai_scenario.py - Metrics Engine
src/metrics/metrics_engine.py - Telemetry Logging
src/metrics/logging_engine.py
Other components
- Operator
Connections 30
- Operator → Web Frontend: operates
- Web Frontend → API Client: requests
- API Client → REST and WebSocket API: calls
- REST and WebSocket API → Application Controller: controls
- Operator → Desktop GUI: operates
- Desktop GUI → Application Controller: controls
- Operator → CLI Entry: invokes
- CLI Entry → Application Controller: initializes
- Application Controller → Configuration: loads
- Application Controller → Scenario Manager: manages
- Scenario Manager → Configuration: loads and saves
- Application Controller → Target Motion: advances
- Application Controller → Disturbance Engine: applies
- Application Controller → Simulation World: renders
- Application Controller → Simulation and MP4 Frames: gets frames
- Simulation and MP4 Frames → Baseline Tracker: provides frames
- Application Controller → Algorithm Plugins: discovers algorithms
- Algorithm Plugins → Baseline Tracker: loads plugin
- Baseline Tracker → Beacon Detection: detects candidates
- Baseline Tracker → Temporal Tracking: tracks candidates
- Application Controller → PTZ Control: computes commands
- Application Controller → Benchmark Manager: runs benchmark
- Benchmark Manager → Simulation and MP4 Frames: evaluates frames
- Benchmark Manager → Ground Truth: reads truth
- Benchmark Manager → Metrics Engine: records metrics
- Benchmark Manager → AI Scenario Workflow: dispatches prompts
- AI Scenario Workflow → Benchmark Manager: executes evaluation
- Application Controller → Telemetry Logging: records telemetry
- Application Controller → Visualization: renders view state
- REST and WebSocket API → Results Views: streams results