Match Data: LaTeX

Copy a block straight into the paper. The tables carry the paper's own wording, which differs from the schema's in places. The JSON figure is cut down from the format's sample file to the fields the schema requires, so its field names always match the validator. All blocks are regenerated from format version 0.3.2 whenever the schemas change.

cdf-matchdata-required

40 rows · .txt · .pdf
\begin{table}[H]
    \caption{Description of the mandatory Match Sheet Data CDF fields. Any description ending with a $^\star$ is repeated once per player. Only players named to the match day squad are listed. Any description ending with a $^\dagger$ is repeated once per event. Note that \{i\} is used as an index for the items in a list. Figure~\ref{fig:match-data-json} describes the specific format for providing results.}
    \label{tab:cdf-matchdata-required}
    \begin{adjustbox}{max width=\textwidth}
    \begin{tabular}{lp{2.75cm}p{7cm}l}
    \hline
    Root & Field & Description & Type \\ \hline
match & id & Unique match identifier & String \\
match/status & is\_neutral & Denotes whether the game was hosted in a neutral venue (true) or not (false) & Boolean \\
match/status & has\_extratime & Denotes whether the game went to extra time (true) or not (false) & Boolean \\
match/status & has\_shootout & Denotes whether the game had a penalty shootout (true) or not (false) & Boolean \\
match/result/final & \{home\text{\textbar}away\} & Result after the final whistle excluding penalty shootout goals (i.e. home goals, away goals) & Integer \\
match/result/final & winning\_team\_id & Unique identifier of the winning team, null when the match was drawn and no shootout was played & String / null \\
match/result/first\_half & \{home\text{\textbar}away\} & Result after the first half (i.e. home goals, away goals) & Integer \\
match/result/second\_half & \{home\text{\textbar}away\} & Result after the second half (i.e. home goals, away goals) & Integer \\
match/result/first\_half\_extratime & \{home\text{\textbar}away\} & Result after the first half of extra time (i.e. home goals, away goals). Only required if a game goes to extra time. & Integer \\
match/result/second\_half\_extratime & \{home\text{\textbar}away\} & Result after the second half of extra time (i.e. home goals, away goals). Only required if a game goes to extra time. & Integer \\
match/result/shootout & \{home\text{\textbar}away\} & Score for the penalty shootout (i.e. home goals, away goals, shootout goals only). Only required if a game goes to shootout. & Integer \\
teams/\{home\text{\textbar}away\} & id & Unique identifier for the home or away team & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & id & Unique player identifier$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & first\_name & First name$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & last\_name & Last name$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & team\_id & Unique team identifier denoting the team the player plays for$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & jersey\_number & Jersey number for a player$^\star$ & Integer \\
teams/\{home\text{\textbar}away\}/players/\{i\} & is\_starter & Denotes whether a player started the game (true) or not (false)$^\star$ & Boolean \\
teams/\{home\text{\textbar}away\}/players/\{i\} & has\_played & Denotes whether a player played in game (true) or not (false)$^\star$ & Boolean \\
officials/\{i\} & id & Unique identifier for the official & String \\
events/goals/\{i\} & time & Time a player scored$^\dagger$ & String \\
events/goals/\{i\} & player\_id & Identifier of the player who scored$^\dagger$ & String \\
events/goals/\{i\} & assist\_id & Identifier of the player who assisted, if the goal was assisted else leave as null $^\dagger$. & String / null \\
events/goals/\{i\} & team\_id & Identifier of the team that scored (for own goals this should be identifier of the team that gained a goal). $^\dagger$ & String \\
events/goals/\{i\} & is\_own\_goal & Denotes whether it was an own goal (true) or not (false)$^\dagger$ & Boolean \\
events/goals/\{i\} & is\_penalty & Denotes whether it was a penalty (true) or not (false)$^\dagger$ & Boolean \\
events/goals/\{i\}/score & \{home\text{\textbar}away\} & Team score after the goal$^\dagger$ & Integer \\
events/substitutions/\{i\} & in\_time & Time in UTC a player is substituted in$^\dagger$ & String \\
events/substitutions/\{i\} & in\_player\_id & Unique identifier of the player substituted in$^\dagger$ & String \\
events/substitutions/\{i\} & out\_time & Time the player was substituted out$^\dagger$ & String \\
events/substitutions/\{i\} & out\_player\_id & Identifier of the player that is substituted out$^\dagger$ & String \\
events/substitutions/\{i\} & team\_id & Identifier of the team that made the substitution$^\dagger$ & String \\
events/cards/\{i\} & time & Time in UTC a player received a card$^\dagger$ & String \\
events/cards/\{i\} & player\_id & Identifier of the player who received a card$^\dagger$ & String \\
events/cards/\{i\} & type & Type of card which can be yellow\_card, red\_card or second\_yellow\_card$^\dagger$ & String \\
events/cards/\{i\} & team\_id & Identifier of the team that made the received a card$^\dagger$ & String \\
meta & vendor & Match sheet data vendor name (e.g. ``company\_a'') & String \\
events/goals/\{i\} & period & Period of the game when the goal was scored & String \\
events/substitutions/\{i\} & period & Period of the game when the substitution occurred & String \\
events/cards/\{i\} & period & Period of the game when the card was shown & String \\
\end{tabular}
    \end{adjustbox}
\end{table}

cdf-matchdata-optional

19 rows · .txt · .pdf
\begin{table}[H]
\centering
\caption{Description of the optional Match Sheet Data CDF Fields. Any description ending with a $^\star$ is repeated once per person (e.g., player, referee, coach). For players, only those named to the match day squad are considered. Note that \{i\} is used as an index for the items in a list.}
\label{tab:cdf-matchdata-optional}
\begin{adjustbox}{max width=\textwidth}
\begin{tabular}{lp{2cm}p{7cm}l}
\hline
Root & Field & Description & Type \\ \hline
teams/\{home\text{\textbar}away\} & short\_name & Short name of the home or away team & String \\
teams/\{home\text{\textbar}away\} & formation & Formation label of the home or away team (e.g. ``4-4-2''). See~\ref{app:positions} for more information. & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & alternative\_id & Additional identifier(s) of the player$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & maiden\_name & Maiden name$^\star$. For example, ``Smith'' for Sophia Wilson. & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & short\_name & Short name$^\star$. For example ``Mohamed Salah Hamed Mahrous Ghaly'' as ``Mo Salah'' (or ``Mohamed Salah'') or ``Givanildo Vieira de Sousa'' as ``Hulk''. & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & position\_group & Position group acronym given according to the CDF-compatible groups given in Appendix \ref{app:positions}$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & position & Position label acronym per player given according to the CDF-compatible labels given in Appendix \ref{app:positions}$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & is\_captain & Whether the player is a captain (true) or not (false)$^\star$ & Boolean \\
teams/\{home\text{\textbar}away\}/players/\{i\} & date\_of\_birth & A player's date of birth in YYYY-MM-DD format$^\star$ & String \\
teams/\{home\text{\textbar}away\}/players/\{i\} & height & Height of a player in cm$^\star$ & Integer \\
teams/\{home\text{\textbar}away\}/players/\{i\} & foot & A player's dominant foot, which can take the values left, right or both$^\star$ & String \\
teams/\{home\text{\textbar}away\}/coaches/\{i\} & id & Unique identifier for a coach$^\star$ & String \\
teams/\{home\text{\textbar}away\}/coaches/\{i\} & first\_name & First name$^\star$ & String \\
teams/\{home\text{\textbar}away\}/coaches/\{i\} & last\_name & Last name$^\star$ & String \\
teams/\{home\text{\textbar}away\}/coaches/\{i\} & short\_name & Short name, a combination of First name and Last name (e.g. Jane Doe, not J. Doe)$^\star$ & String \\
officials/\{i\} & first\_name & First name of the official, null if not available & String \\
officials/\{i\} & last\_name & Last name of the official, null if not available & String \\
officials/\{i\} & short\_name & Short name of the official, null if not available & String \\
officials/\{i\} & type & Role of the official (e.g., `main\_referee', `assistant\_referee', `fourth\_official') & String \\
\end{tabular}
\end{adjustbox}
\end{table}

match-data-json

JSON figure · .txt · .pdf
\begin{center}
\begin{minipage}{0.8\linewidth}
\begin{lstlisting}
{
    "match": {
        "id": "123456789",
        "status": {
            "is_neutral": false,
            "has_extratime": true,
            "has_shootout": true
        },
        "result": {
            "final": {"home": 1, "away": 1, "winning_team_id": "T1000"},
            "first_half": {"home": 1, "away": 0},
            "second_half": {"home": 1, "away": 1},
            "first_half_extratime": {"home": 1, "away": 1},
            "second_half_extratime": {"home": 1, "away": 1},
            "shootout": {"home": 5, "away": 4}
        }
    },
    "teams": {...},
    "officials": [...],
    "events": {...},
    "meta": {...}
}
\end{lstlisting}
\captionof{figure}{Simplified example of a partial JSON Object that depicts the structure of the match sheet data. In particular, it describes the format of the results in this data source.}
\label{fig:match-data-json}
\end{minipage}
\end{center}