How yuyaox122/tennis_ml_analysis works
This repository is a tennis-video analysis application. Its main workflow reads a match video, detects and filters players, detects and interpolates the ball, identifies court keypoints, maps detections to a mini-court, computes shot and player speeds, overlays visualizations, and saves a processed video. The graph reflects the sampled main.py orchestration and core modules; README documentation is only a title and link, and unsampled GUI and inference modules are not assigned unverified behavior.
Main entry points: main.py Analysis workflow · mini_court.py Mini-court mapping · video_utilities.py Video I/O · bbox_utilities.py Bounding-box geometry
Components 15
Video input
- Video I/O
utilities/video_utilities.py
Detection and tracking
- Analysis workflow
main.py - Player tracking
trackers/player_tracker.py - Ball tracking
trackers/ball_tracker.py
Court analysis
- Court keypoints
court_line_detector/court_line_detector.py - Mini-court mapping
mini_court/mini_court.py - Bounding-box geometry
utilities/bbox_utilities.py - Distance conversion
utilities/conversion_utilities.py - Court dimensions
constants/__init__.py
Statistics and output
- Shot and player speeds
main.py - Detection overlays
trackers/player_tracker.py - Court overlay
court_line_detector/court_line_detector.py - Mini-court overlay
mini_court/mini_court.py - Statistics overlay
utilities/stats_drawer_utilities.py
Other components
- Video operator
Connections 18
- Video operator → Analysis workflow: starts processing
main.py - Analysis workflow → Video I/O: reads frames
main.py - Analysis workflow → Player tracking: detects and filters
main.py - Analysis workflow → Ball tracking: detects and interpolates
main.py - Analysis workflow → Court keypoints: predicts keypoints
main.py - Analysis workflow → Mini-court mapping: maps detections
main.py - Mini-court mapping → Bounding-box geometry: uses positions
mini_court/mini_court.py - Mini-court mapping → Distance conversion: converts distances
mini_court/mini_court.py - Mini-court mapping → Court dimensions: uses dimensions
mini_court/mini_court.py - Analysis workflow → Shot and player speeds: calculates speeds
main.py - Shot and player speeds → Bounding-box geometry: measures distances
main.py - Shot and player speeds → Distance conversion: converts distances
main.py - Shot and player speeds → Court dimensions: uses dimensions
main.py - Analysis workflow → Detection overlays: draws detections
main.py - Analysis workflow → Court overlay: draws keypoints
main.py - Analysis workflow → Mini-court overlay: draws mapped points
main.py - Analysis workflow → Statistics overlay: draws statistics
main.py - Analysis workflow → Video I/O: saves result
main.py