Version 0.3.2
This schema defines the Meta Data as described in the Common Data Format paper.
Unique identifier for the competition
Name of the competition
Specifying the competition set-up such as league18 (i.e., league involving 18 teams), league20, knockoutneutral, etc.
Age restriction for the competition (e.g., 'U18', 'U20')
Type of competition (e.g., 'youth', 'mens', 'womens')
Unique identifier for the season
Season name (e.g., '2022/23')
Unique identifier for the match
Scheduled kickoff time in UTC
If the conditions in the "If" tab are respected, then the conditions in the "Then" tab should be respected. Otherwise, the conditions in the "Else" tab should be respected.
"shootout"
Period of the match which can be firsthalf, secondhalf, firsthalfextratime, secondhalfextratime, or shootout
The direction of play for the home team. Possible options are leftright or rightleft.
Start time of the period in UTC
End time of the period in UTC
Frame identifier for the tracking data related to the start of the period
Frame identifier for the tracking data related to the end of the period
Unique team identifier of the team playing on the left side of the pitch in this period. The CDF requires a standardized playing direction. The leftteamid and rightteamid should be the actual, non-standardized sides.
Unique team identifier of the team playing on the right side of the pitch in this period.
Whistles that start and end major periods of play
No Additional ItemsWhistles that start and end major periods of play such as the start and end of halves and interruptions (e.g., weather, VAR review, player health events, streakers or abandoned). Examples of types firsthalf, secondhalf, weatherdelay, healthdelay, injurytreatment fanhealth_delay etc.
Sub type related to an interruption, for example 'start' or 'end'
The time in UTC of the whistle
Round of the match (e.g. 1, 2, 3, final, semi_final)
Scheduled kickoff time in UTC
Local kickoff time
Country where the match is played
City where the match is played
Indicates if the roof is open (true) or closed (false)
Precipitation during the match in millimetres
Unique identifier for the home or away team
Array of player objects. One array under teams/home, one array under teams/away
No Additional ItemsUnique player identifier
Unique team identifier denoting the team the player plays for
Jersey number for a player
Denotes whether a player started the game (true) or not (false)
Last name of the player, null if not available
First name of the player, null if not available
Name of the team
Jersey colour of the team as a hexadecimal color code (e.g. #545B62).
Unique identifier for the venue or stadium.
Length of the pitch in metres, null if not available
Width of the pitch in metres, null if not available
Name of the venue or stadium
Information on the turf of the stadium (natural, natural_reinforced, grass, clay,...)
Video meta data information, null if not relevant
Camera perspective (e.g. 'instadium', 'broadcast', 'tactical', 'tacticalwide')
Version number for the video data collection in use (e.g. '0.1.0')
Vendor name of the video data
Frames per second (i.e., frame rate) of tracking, landmark tracking or video
Event data meta information, null if not relevant
Indicates if the event data was collected 'live' or 'post_match'.
Vendor name of the event data
Version number for the event data collection in use (e.g. '0.1.0')
Tracking data meta information, null if not relevant
Version number for the tracking data collection in use (e.g. '0.1.0')
Vendor name of the tracking data
Frames per second (i.e., frame rate) of tracking, landmark tracking or video
Indicates if the tracking data was collected 'live' or 'post_match'.
Landmark tracking data meta information, null if not relevant
Version number for the landmark data collection in use (e.g. '0.1.0')
Vendor name of the landmark tracking data
Frames per second (i.e., frame rate) of tracking, landmark tracking or video
Indicates if the landmark data was collected 'live' or 'post_match'.
Skeletal hierarchy used: which landmarks are tracked and how they are connected. Required when landmark data is provided. Every name here is a landmark name from the landmark data.
Name of the landmark the hierarchy is rooted at
Must match regular expression:^[a-z][a-z0-9_]*$
Names of every landmark in the hierarchy
No Additional Items^[a-z][a-z0-9_]*$
Parent-child pairs describing how the landmarks connect
No Additional ItemsName of the parent landmark
Must match regular expression:^[a-z][a-z0-9_]*$
Name of the child landmark
Must match regular expression:^[a-z][a-z0-9_]*$
Ball tracking data meta information, null if not relevant. Only relevant when providing an independent ball file.
Version number for the ball data collection in use (e.g. '0.1.0')
Vendor name of the ball data
Frames per second (i.e., frame rate) of ball tracking
Indicates if the ball data was collected 'live' or 'post_match'.
Meta information
Version number for the data collection in use (e.g. '0.1.0')
Vendor name of the meta data
Common Data Format (CDF) meta information
Version number for the data collection in use (e.g. '0.1.0')
Unique identifier for the official
First name of the official, null if not available
Last name of the official, null if not available
Short name of the official, null if not available
Role of the official (e.g., 'mainreferee', 'assistantreferee', 'fourth_official')