Common Data Format - Event Data Schema

Type: object

Version 0.2.2

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

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

Type: object

Type: string

Unique match identifier

Type: object

Type: boolean

Indicates if synced tracking data is available (true) or not (false)

Type: object

Type: string

Unique identifier of the event

Type: stringFormat: date-time

Absolute time in UTC of when the event started

Type: enum (of string)

Must be one of:

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

Type: string

Name of the event type

Type: string or null

Name of the event subtype

Type: boolean

Denotes whether the event was successful (true) or not (false)

Type: string

Detailed event outcome options

Type: string

Unique identifier of the player performing the action

Type: string

Unique team identifier of the player performing the action

Type: string or null

Unique identifier of the player receiving a pass, leave null if event is not a pass

Type: string or nullFormat: date-time

Absolute time in UTC of the first moment the ball was received

Type: number

x location where the action of player_id happened (m)

Type: number

y location where the action of player_id happened (m)

Type: number

x location where the action of player_id ended (m)

Type: number

y location where the action of player_id ended (m)

Type: enum (of string)

Denotes the body part used by player_id

Must be one of:

  • "left_foot"
  • "right_foot"
  • "head"
  • "other"

Type: string

The match clock as a string in format MM:SS.mm

Type: object or null

Type: number or null

Calculated xG value between [0,1]

Type: number or null

Calculated post-shot xG value between [0,1]

Type: number or null

Calculated xPass value between [0,1]

Type: number or null

Expected possession value between [-1,1]

Type: integer or null

Number of opposing players that have been outplayed by a pass according to the traditional packing approach

Type: integer or null

Number of opposing players that have been outplayed by a pass according to the horizontal packing approach

Type: object or null

Type: boolean

Was this event reviewed by the video assistant referee (true) or not (false

Type: boolean

Was the ruling on the field confirmed (true) or not (false)

Type: object

Type: integer or null

Frame identifier from the tracking data related to the event at (x, y)

Type: integer or null

Frame identifier from the tracking data related to the event at (xend, yend)

Type: object

Type: number

x location of the player committing the action according to the tracking data

Type: number

y location of the player committing the action according to the tracking data