Common Data Format - Tracking Data Schema

Type: object

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

root timestamp
Type: stringFormat: date-time

root period
Type: enum (of string)

Must be one of:

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

root match
Type: object

root match id
Type: string

root teams
Type: object

root teams home
Type: object

root teams home id
Type: string

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

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

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

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

root teams home players players items vel
Type: number

root teams home players players items acc
Type: number

root teams home players players items lat
Type: number

root teams home players players items long
Type: number

root teams home name
Type: string

root teams home jersey_colour
Type: string

root teams home formation
Type: string

root ball
Type: object

root ball x
Type: number or null

root ball y
Type: number or null

root ball z
Type: number or null

root referees
Type: array of object
No Additional Items

Each item of this array must be:

root referees referees items
Type: object

root referees referees items id
Type: string

root referees referees items x
Type: number or null

root referees referees items y
Type: number or null

root referees referees items z
Type: number or null

root referees referees items vel
Type: number

root referees referees items acc
Type: number

root referees referees items lat
Type: number

root referees referees items long
Type: number

root referees referees items is_visible
Type: boolean

root ball_status
Type: boolean

root ball_poss_team_id
Type: string

root ball_poss_status
Type: string

root vendor
Type: object

root vendor event
Type: object

root vendor event name
Type: string

root vendor tracking
Type: object

root vendor tracking name
Type: string