Universal Match Format (.parquet)

from datetime import datetime
from padelkit import (
    BallProperties,
    Court,
    CourtLocation,
    CourtSetting,
    EnvironmentConditions,
    Match,
    MatchConfiguration,
    MatchTimeline,
    PadelVisualizer,
    Player,
    SurfaceMaterials,
    Team,
    TeamId,
)

# 1. Define static court, atmosphere, and match entities
court = Court(
    turf_color="blue",
    setting=CourtSetting.OUTDOOR,
    location=CourtLocation(
        club="Wizink Center",
        city="Madrid",
        country="Spain",
        latitude=40.4239,
        longitude=-3.6718,
    ),
)
env = EnvironmentConditions.from_atmosphere(
    temperature_c=24.0,
    altitude_m=655.0,
    relative_humidity=0.42,
)
team_a = Team(TeamId.A, Player("A. Coello"), Player("A. Tapia"), name="Team A")
team_b = Team(TeamId.B, Player("A. Galan"), Player("F. Chingotto"), name="Team B")
match = Match(
    teams={TeamId.A: team_a, TeamId.B: team_b},
    config=MatchConfiguration(advantage_method="gold_point"),
    court=court,
    date=datetime(2026, 5, 10, 18, 30),
)
match.history.add_point(TeamId.A)

# 2. Generate or record a 60 FPS timeline and bake 3D skeletons
timeline = MatchTimeline.demo_rally(
    court=court,
    environment=env,
    ball_properties=BallProperties.fip_standard(),
    surface_materials=SurfaceMaterials.fip_standard(),
    match=match,
    bake_skeleton=True,
)

# 3. Save to a single self-contained .parquet file
timeline.to_parquet("madrid_premier_point1.parquet")

# 4. Reload with full domain reconstruction or open in 3D Studio
loaded = MatchTimeline.from_parquet("madrid_premier_point1.parquet")
print(loaded.court.location.city, loaded.environment.temperature_c)

viz = PadelVisualizer.from_parquet("madrid_premier_point1.parquet")
viz.export_html("point1_3d_replay.html")

import json
import pyarrow.parquet as pq

schema = pq.read_schema("madrid_premier_point1.parquet")
envelope = json.loads(
    schema.metadata[b"padelkit_metadata"].decode("utf-8")
)

print("Schema version:", envelope["schema_version"])
print("Joint convention:", envelope["joint_convention"])
print("Venue:", envelope["court"]["location"]["venue_name"])
print("Temp (C):", envelope["environment"]["temperature_c"])