How bastendekoninck/football-vision works
football-vision processes match footage through detection, pitch-based filtering, jersey-colour classification, and count validation. The Pipeline owns the runtime sequence and returns classified detections plus validation metrics. The extractor and filter/classifier relationships are supported by their source excerpts; the user-facing setup and returned outputs are documented in the README. The graph focuses on these product stages rather than packaging or development tooling.
Main entry points: pipeline.py Pipeline · detection.py YOLO Detector · filter.py Pitch Filter · classifier.py GMM Classifier
Components 12
Orchestration
- Pipeline
src/football_vision/pipeline.py
Detection
- YOLO Detector
src/football_vision/detection.py - Detections
src/football_vision/detection.py
Pitch Processing
- Pitch Filter
src/football_vision/filter.py - Pitch Mask Extractor
src/football_vision/pitch_mask.py
Classification And Validation
- GMM Classifier
src/football_vision/classifier.py - Jersey Feature Extractor
src/football_vision/classifier.py - Frame Ground Truth
src/football_vision/validation.py - Count Validator
src/football_vision/validation.py - Classifications And Metrics
src/football_vision/validation.py
Other components
- Engineer
- Match Footage
Connections 13
- Engineer → Pipeline: configures and runs
README.md - Pipeline → YOLO Detector: requests detections
src/football_vision/pipeline.py - Match Footage → YOLO Detector: provides frames
README.md - YOLO Detector → Detections: yields
src/football_vision/detection.py - Pipeline → Pitch Filter: applies filters
src/football_vision/pipeline.py - Pitch Filter → Pitch Mask Extractor: extracts masks
src/football_vision/filter.py - Pipeline → GMM Classifier: classifies detections
src/football_vision/pipeline.py - GMM Classifier → Jersey Feature Extractor: gets features
src/football_vision/classifier.py - Jersey Feature Extractor → Pitch Mask Extractor: extracts masks
src/football_vision/classifier.py - Pipeline → Count Validator: validates counts
src/football_vision/pipeline.py - Frame Ground Truth → Count Validator: supplies counts
README.md - Pipeline → Classifications And Metrics: returns results
src/football_vision/pipeline.py - Engineer → Match Footage: provides source
README.md