Skip to content

padex.schemas

Pydantic data models used across all pipeline layers.

Tracking Models

padex.schemas.tracking.PlayerFrame

Bases: BaseModel

Per-frame tracking data for a single player.

padex.schemas.tracking.BallFrame

Bases: BaseModel

Per-frame tracking data for the ball.

padex.schemas.tracking.CourtCalibration

Bases: BaseModel

Homography calibration from pixel coordinates to court coordinates.

padex.schemas.tracking.Position2D

Bases: BaseModel

2D position on the court in meters. Origin at bottom-left corner.

Event Models

padex.schemas.events.Shot

Bases: BaseModel

Atomic unit of padel data — a single shot with its full trajectory.

padex.schemas.events.Bounce

Bases: BaseModel

A single bounce in the ball trajectory.

padex.schemas.events.ShotType

Bases: str, Enum

Padel-specific shot type taxonomy.

padex.schemas.events.BounceType

Bases: str, Enum

Surface where the ball bounced.