Tutorial supported by EU project SoBigData++ RI (Grant Agreement 871042).
A video version of the tutorial is available on YouTube at:
- https://www.youtube.com/watch?v=ZXEHPKmx410&t=430s (Luca Pappalardo)
- https://www.youtube.com/watch?v=TCyahs5HRMM (Paolo Cintia)
The code has been developed by:
- Luca Pappalardo, National Research Council of Italy (CNR), luca.pappalardo@isti.cnr.it
- Alessio Rossi, University of Pisa, alessio.rossi2@gmail.com
- Paolo Cintia, University of Pisa, paolo.cintia@di.unipi.it
and explores the events in an open collection of soccer-logs described in the following paper (please cite it if you use the public data of the code in this folder):
- (PCR2019) Pappalardo, L., Cintia, P., Rossi, A. et al. A public data set of spatio-temporal match events in soccer competitions. Nature Scientific Data 6, 236 (2019). https://doi.org/10.1038/s41597-019-0247-7
The soccer-logs have been collected and provided by Wyscout. The procedure of data collection is performed by expert video analysts (the operators), who are trained and focused on data collection for soccer, through a proprietary software (the tagger). The tagger has been developed and improved over several years and it is constantly updated to always guarantee better and better performance at the highest standards.
Based on the tagger and the videos of soccer games, to guarantee the accuracy of data collection, the tagging of events in a match is performed by three operators, one operator per team and one operator acting as responsible supervisor of the output of the whole match. Optionally for near-live data delivery a team of four operators is used, one of them acting to speed up the collection of complex events which need additional and specific attributes or a quick review. Further details on data collection can be found in the data paper (PCR2019).
The data sets are released under the CC BY 4.0 License and are publicly available on figshare:
- Pappalardo, Luca; Massucco, Emanuele (2019): Soccer match event dataset. figshare. Collection. https://doi.org/10.6084/m9.figshare.c.4415000.v5
The data refer to season 2017/2018 of five national soccer competitions in Europe: Spanish first division, Italian first division, English first division, German first division, French first division. In addition, there are data about the World cup 2018 and the European cup 2016, which are competitions for national teams. In total, we provide seven data sets corresponding to information about all competitions, matches, teams, players, events, referees and coaches.
Each data set is provided in JSON format (JavaScript Object Notation). The following table shows the list of competitions we make available with their total number of matches, events and players. The data covers a total of around 1,941 matches, 3,251,294 events and 4,299 players.
| Competition | #matches | #events | #players |
|---|---|---|---|
| Spanish first division | 380 | 628,659 | 619 |
| English first division | 380 | 643,150 | 603 |
| Italian first division | 380 | 647,372 | 686 |
| German first division | 306 | 519,407 | 537 |
| French first division | 380 | 632,807 | 629 |
| World cup 2018 | 64 | 101,759 | 736 |
| European cup 2016 | 51 | 78,140 | 552 |
| 1,941 | 3,251,294 | 4,299 |
- Import libraries
- Load public datasets
- How are the data collected?
- Structure of data
- Players
- Competitions
- Matches
- Events
- Basic statistics on events
- Frequency of events by type
- Distribution of number of events per match
- Plot events on the field
- Static plot
- Interactive plot
- Spatial distribution of events
- Intra-match evolution
- Advanced statistics
- Passing networks
- Flow centrality
- PlayeRank algorithm