Skip to content

padex.tracking

Layer 1: CV pipeline for player detection, ball tracking, and court calibration.

padex.tracking.pipeline.TrackingPipeline

End-to-end tracking pipeline: video → structured tracking data.

Stages: 1. Court calibration — sample frames to find best homography 2. Per-frame player detection + tracking 3. Ball detection + Kalman tracking (batch)

run(start_frame=0, end_frame=None, step=1)

Run the full tracking pipeline.

Parameters:

Name Type Description Default
start_frame int

First frame to process.

0
end_frame int | None

Last frame (exclusive). None for entire video.

None
step int

Process every Nth frame.

1

Returns:

Type Description
TrackingResult

TrackingResult with player_frames, ball_frames, calibration.

padex.tracking.pipeline.TrackingResult dataclass

Output of the tracking pipeline.