Common Data Format - Tracking Data Schema

Type: object

Version 0.3.2

This schema defines the Tracking Data as described in the Common Data Format paper.

This schema describes a single JSON Object with a JSON Lines file.

root frame_id
Type: integer

Unique frame identifier

root timestamp
Type: stringFormat: date-time

Timestamp of the frame in UTC

root period
Type: enum (of string)

Period of the match (firsthalf, secondhalf, firsthalfextratime, secondhalfextratime, shootout)

Must be one of:

  • "first_half"
  • "second_half"
  • "first_half_extratime"
  • "second_half_extratime"
  • "shootout"

root match
Type: object

root match id
Type: string

Unique match identifier

root teams
Type: object

root teams home
Type: object

root teams home id
Type: string

Unique identifier for the home or away team

root teams home players
Type: array of object
No Additional Items

Each item of this array must be:

root teams home players players items
Type: object

root teams home players players items id
Type: string

Unique identifier for a player

root teams home players players items x
Type: number or null

x location of the player on the pitch (m).

root teams home players players items y
Type: number or null

y location of the player on the pitch (m).

root teams home players players items z
Type: number or null

z location of the player on the pitch (m).

root teams home players players items vel
Type: number

Speed of the player/ball (m/s)

root teams home players players items acc
Type: number

Acceleration of the player/ball (m/s^2)

root teams home players players items lat
Type: number

latitude of the player's position if the data is collected by GNSS or GPS

root teams home players players items long
Type: number

longitude of the player's position if the data is collected by GNSS or GPS

root teams home players players items is_visible
Type: boolean

Denotes if a player was visible (in view of the camera) (true) or not (false)

root teams home players players items dist
Type: number

Distance covered by the player/ball in the current frame (m)

root ball
Type: object

root ball x
Type: number or null

x location of the ball on the pitch (m).

root ball y
Type: number or null

y location of the ball on the pitch (m).

root ball z
Type: number or null

z location of the ball on the pitch (m).

root ball status
Type: boolean

Indicates if the ball is either in play (true) or out of play (false)

root ball poss_team_id
Type: string

Unique identifier of the team that currently possesses the ball

root ball poss_status
Type: string

Contextual description of the level of control (e.g., controlled, contested,...)

root officials
Type: array of object
No Additional Items

Each item of this array must be:

root officials officials items
Type: object

root officials officials items id
Type: string

Unique identifier for an official

root officials officials items x
Type: number or null

x location of the official on the pitch (m)

root officials officials items y
Type: number or null

y location of the official on the pitch (m)

root officials officials items z
Type: number or null

z location of the official on the pitch (m)

root officials officials items vel
Type: number

Speed of the official (m/s)

root officials officials items acc
Type: number

Acceleration of the official (m/s^2)

root officials officials items lat
Type: number

Latitude of the official's position if the data is collected by GNSS or GPS

root officials officials items long
Type: number

Longitude of the official's position if the data is collected by GNSS or GPS

root officials officials items is_visible
Type: boolean

Denotes if an official was visible (in view of the camera) (true) or not (false)