How shalikha/thesis works
This repository provides monocular-video traffic analysis: calibration maps image pixels to world coordinates, then vehicle geometry supports speed and inter-vehicle analysis. Users can also compare localization approaches, refine 3D boxes interactively, or run a segmentation/keypoint fallback pipeline. A separate calibration utility selects reference points and builds a lookup table, with optional video stabilization and ROI tools. The README documents these capabilities; arrows between independently documented tools are omitted unless a source excerpt shows the call. Some implementation details, especially comparison and fallback internals, were not fully sampled.
Main entry points: main.py Calibration Runner · speed_estimator.py Speed Estimator · distance_analyzer.py Distance and Overtaking · bbox_3d_generator.py 3D Box Generator
Components 14
Calibration Tools
- Calibration Runner
utils/calibration_tool/main.py - Reference Point Selector
utils/calibration_tool/utils/selectPoints.py - Calibration Mapping
utils/calibration_tool/utils/calibration.py - Video Stabilization
utils/calibration_tool/stabilization.py - ROI Selection
utils/calibration_tool/utils/roi.py - Calibration Lookup
data/calibration-lookup-table.npy
Vehicle Geometry
- 3D Box Generator
src/bbox_3d_generator.py - Interactive Box Refinement
src/interactive_3d_bbox.py
Traffic Analysis
- Speed Estimator
src/speed_estimator.py - Distance and Overtaking
src/distance_analyzer.py - Analysis Outputs
output
Alternative Methods
- Approach Comparison
src/compare_all_approaches.py - Contact-Point Fallback
src/fallback.py
Other components
- Video Analyst
Connections 17
- Video Analyst → Calibration Runner: runs calibration
README.md - Calibration Runner → Reference Point Selector: selects points
utils/calibration_tool/main.py - Calibration Runner → Calibration Mapping: builds lookup
utils/calibration_tool/main.py - Calibration Mapping → Calibration Lookup: generates mapping
- Video Analyst → Video Stabilization: stabilizes video
README.md - Video Stabilization → ROI Selection: uses ROI tool
utils/calibration_tool/stabilization.py - Video Analyst → Speed Estimator: estimates speed
README.md - Speed Estimator → 3D Box Generator: processes frames
src/speed_estimator.py - Video Analyst → Distance and Overtaking: analyzes spacing
README.md - Distance and Overtaking → 3D Box Generator: generates 3D boxes
src/distance_analyzer.py - Video Analyst → Interactive Box Refinement: refines boxes
README.md - Interactive Box Refinement → 3D Box Generator: detects vehicles
src/interactive_3d_bbox.py - Video Analyst → Approach Comparison: compares approaches
README.md - Video Analyst → Contact-Point Fallback: runs fallback
README.md - Speed Estimator → Analysis Outputs: exports video
README.md - Distance and Overtaking → Analysis Outputs: exports video
README.md - Contact-Point Fallback → Analysis Outputs: exports CSV
README.md