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.

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.