Common Data Format for Football

Schema Documentation & Validation

Version 0.2.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 →

Event Data

Event-based data including match events and timestamps

View Schema →

🏃🏽‍♂️‍➡️

Tracking Data

Player and ball tracking positional coordinate data

View Schema →

Match Data

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

View Schema →

Skeletal Data

Skeletal tracking, body pose estimation and landmarks data

View Schema →

Video Data

Video metadata, camera information, and frame references

View Schema →

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.