Bucket a bounce into long / wide / net. Order matters: net zone wins over long/wide because a bounce right at the net is ambiguous in pure-co

Court reference with the same pixel bounds as CourtReference uses. left_x = 286, right_x = 1379 (span 1093) top_y = 561, bottom_y = 2935 (sp

Step forward/back skipping any slide marked data-deck-skip. Falls * back to _go's clamp-at-ends behaviour (flash overlay) when there's * n

Return a Supabase client. Reads credentials directly from the .env file to avoid stale shell env vars overriding load_dotenv() — same pattern

Build structured rallies from raw pipeline streams. Output shape documented in docs/RALLY_TRACKING_SPEC.md.

Build a ball_track list of length n_frames with positions at given frames.

Processes a single frame, using internal buffer for context.

Merge bounces and swings into one frame-sorted event list. Each event has: - kind: "bounce" | "swing" - frame: int - bounce ext

Project a bounce's ball pixel position through homography into svg units. Returns None if any input is missing or projection fails.

Detect players in a single frame and extract pose keypoints. Args: frame: Single video frame (numpy array, BGR).

Current slide index (0-based).

Load homography matrices and keypoints for a camera from the calibration JSON. Returns: (H_ref, H_frame, keypoints) H_ref:

Return a positive score if this detection is a valid far player, else 0. Projects the bbox foot position to court-space using H_ref and chec

Fill empty player-detection frames by linearly interpolating between the nearest non-empty frames on either side. Empty frames arise whe

Return (event_index, distance) of the nearest event within ±window, or None.

Split a sorted event list into rally groups by RALLY_GAP_SECONDS. A gap > gap_frames between consecutive events starts a new rally.

Aggregate rally stats for the match-detail tile rail and Coach card. Truncated rallies (clipped by the recording's start/end) keep their leng

Main pipeline entry point (Modal-compatible).

Apply 2x2 affine matrix M to (x, y) channels. Confidence untouched.

Run court detection on the provided frames and return the homography matrix + keypoints from the frame with the most valid detected keypoints

Return the real uc_davis_court1 H_ref from calibration.

Project a player's foot position (bottom-center of bbox) to court reference space.

Create court reference image using the lines positions

* Tidy a raw recording title for display — strips the file extension and * collapses underscores. Used when the upload didn't supply an explicit titl

For each bounce frame, return its court coords + side, or None if invalid. Returns dict mapping bounce_frame -> { "svg_x": float, # 0-30

Returns: H_ref: frame -> reference court H_frame: reference court -> frame

Main pass + ROI backfill in one call. Strategy: - Always run the main full-frame pass (preserves trajectory continuity

:params feature_map: feature map with shape (1,360,640) prev_pred: [x,y] coordinates of ball prediction from previous

Append temporal derivatives to a (T, D) pose feature sequence. Velocity (1st derivative) carries direction-of-motion signal that raw position

Look up the stroke label for a given frame from frame_stroke_labels. Searches frame_idx and a ±window frame window around it. Returns the

Tag the last non-skipped slide so print CSS can drop its * break-after (see the @media print comment above — :last-child * alone matches a

Lazily build the clone for a thumb that has scrolled into view.

Project a frame-space point to court-space via homography. Returns (cx, cy) or None.

Save a heatmap image to disk as landscape (rotated 90 CW so near baseline is on the right).