Common Data Format for Football

Schema Documentation & Validation

Version 0.3.2

These schemas define the Common Data Format (CDF) as described in (Anzer et al. 2025).

If you have any suggestions for the Common Data Format, please Open an Issue.

📋

Meta Data

Match information and information about other provided data.

View Schema → View LaTeX →
âšŊ

Event Data

Event-based data including match events and timestamps

View Schema → View LaTeX →
🏃đŸŊ‍♂ī¸â€âžĄī¸

Tracking Data

Player and ball tracking positional coordinate data

View Schema → View LaTeX →
ℹī¸

Match Data

Match-level information, teams, scores, line-ups etc.

View Schema → View LaTeX →
đŸĻĩđŸŊ

Landmark Data

Landmark tracking, body pose estimation and landmarks data

View Schema → View LaTeX →
📹

Video Data

Video metadata, camera information, and frame references

View Schema → View LaTeX →

Validate Your Data

Use the common-data-format-validator Python package to validate your data against these schemas.

pip install common-data-format-validator

Work In Progress: CDF Support In Kloppy

PySport is working to integrate Common Data Format support into Kloppy.

from kloppy import skillcorner # or any of the following providers: # hawkeye, metrica, pff, signality, sportec, statsperform, tracab dataset = skillcorner.load_open_data() dataset.to_cdf()

Work In Progress: CDF as a IEEE Standard

The Common Data Format as IEEE Standard, find more information here.