Common Data Format - Landmark Tracking Data Schema

Type: object

Version 0.3.2

This schema defines the Landmark 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 which can be firsthalf, secondhalf, firsthalfextratime, secondhalfextratime, or 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
No Additional Items

Each item of this array must be:

root teams home players player
Type: object

root teams home players players items id
Type: string

Unique identifier for a player

root teams home players players items landmarks
Type: array
No Additional Items

Each item of this array must be:

root teams home players players items landmarks landmark
Type: object

root teams home players players items landmarks landmarks items name
Type: string

Name for a landmark

Must match regular expression: ^[a-z][a-z0-9_]*$

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

Relative x coordinate of landmark in relation to the point of origin (m)

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

Relative y coordinate of landmark in relation to the point of origin (m)

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

Relative z coordinate of landmark in relation to the point of origin (m)

root teams home players players items landmarks landmarks items is_visible
Type: boolean

If landmark is detected (true) or inferred (false)

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)