Common Data Format - Skeletal Tracking Data Schema

Type: object

Version 0.2.2

This schema defines the Skeletal 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

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 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 index
Type: string

Unique identifier for a landmark

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

Name for a landmark

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

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

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

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

root teams home players players items landmarks landmarks items children
Type: array of integer

List of children indexes associated with keypoint

 No Additional Items

Each item of this array must be:

root teams home players players items landmarks landmarks items children children items
Type: integer

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

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

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

root ball y
Type: number

root ball z
Type: number

root ball_status
Type: boolean

root ball_poss_team_id
Type: string

root ball_poss_status
Type: string

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

root referees referees items y
Type: number

root referees referees items z
Type: number

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 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