Skip to main content

SciSports Events XML

How to extract data-driven actionable insights using the SciSports Events XML?

The SciSports Events XML timeline provides a structured timeline of match events that can be exported from the Performance Center and imported into external video analysis tools. This enables analysts to combine event data with video workflows and review specific match actions in video analysis tools.

Download the SciSports Events XML timelines

The SciSports Events XML timelines are available within the dataset of a processed match in the Performance Center.

To locate the XML timelines:

  1. Open the Performance Center

  2. Navigate to Data center

  3. Click on Datasets

  4. Click on the name of the desired match

  5. Select the header: Timelines

  6. Locate the file named SciSportsEventsXml
    ​

  7. Select one or multiple boxes in front of the file

  8. Select the orange download button
    ​Or

  9. press the grey download button in the actions part of the table

Each match contains three separate XML timelines:

  • First half timeline

  • Second half timeline

  • Full match timeline

Events included in the XML timeline

The SciSports Events XML timeline contains a set of on-ball events on both team and player level. Each event is stored using tags so that video analysis tools can categorize and filter actions efficiently.

For a complete overview of the event definitions used by SciSports, see the related article: SciSports Event Types

Structure of the XML timeline

The SciSports Events XML timeline is organized into multiple timelines representing different match perspectives. These timelines allow video analysis tools to structure and categorize match actions efficiently.

Each XML export contains the following components:

Team timelines

Timelines that contain events performed by the team. These timelines store team-level actions across the match.

Player timelines

Timelines that contain events assigned to individual players. Each player has a separate timeline containing the events associated with that player.

Sequence timelines

Sequences are included to represent continuous periods of possession. A sequence describes a period of play in which a team maintains control of the ball and is defined by its start and end result.

When tracking data is available, sequences follow the same definitions used in the Sequences feature based on tracking analysis. When tracking data is not available, sequences are generated using event data only and align with the sequences shown in the Sequences feature inside the Performance Center.

  • In this article you can find the sequence definitions for event data only

  • In this article you can find the sequence definitions for event- and tracking data

This structure allows analysts to efficiently locate, filter, and review match events when working with video analysis workflows.

Automating downloads via the API

For workflows that require automated data retrieval, the SciSports Performance Center API can be used to download the XML timelines programmatically.

Importing the XML timeline into a video analysis tool

A step-by-step guide on how to import the SciSports Events XML in your own video tool, can be found here.

For further assistance or to share feedback about this feature, contact the SciSports Support Team at [email protected].

Did this answer your question?