v3.16.0

✨ Highlights ✨

Load DFL Open Data by @UnravelSports in #365

We've added support for loading a new public dataset! The dataset contains seven full matches of raw event and position data collected by Sportec Solutions from the German Men's Bundesliga season 2022/23 first and second division.

from kloppy import sportec

event_dataset = sportec.load_open_event_data(match_id="J03WMX")
tracking_dataset = sportec.load_open_tracking_data(match_id="J03WMX")

For more info about the dataset, see

Bassek, M., Weber, H., Rein, R., & Memmert, D. (2024). "An integrated dataset of synchronized spatiotemporal and event data in elite soccer." In Submission.

Standardized player positions by @DriesDeprest in #334

Instead of relying on provider-specific player positions, kloppy now implements a standardized PositionType.

>>> from kloppy import statsbomb

>>> event_dataset = statsbomb.load_open_data(match_id="15946")
>>> event = event_dataset.get_event_by_id("549567bd-36de-4ac8-b8dc-6b5d3f1e4be8")
>>> event.player.starting_position
<PositionType.LeftMidfield: ('Left Midfield', 'LM', 'WideMidfield')>

The positions are ordered hierarchically.

>>> from kloppy.domain import PositionType

>>> print(PositionType.LeftBack.parent) 
FullBack

>>> print(PositionType.Defender.is_subtype_of(PositionType.Defender))
True
>>> print(PositionType.LeftCenterBack.is_subtype_of(PositionType.Defender))  
True
>>> print(PositionType.LeftBack.is_subtype_of(PositionType.Midfielder))  
False

>>> print(PositionType.LeftCenterBack) 
Left Center Back
>>> print(PositionType.LeftCenterBack.code) 
LCB

Team formation changes by @DriesDeprest in #332

In addition to a starting_formation attribute, a Team entity now also has a formations attribute that holds the team's formation changes throughout the game.

>>> from kloppy import statsbomb

>>> event_dataset = statsbomb.load_open_data(match_id="15946")
>>> event = event_dataset.get_event_by_id("549567bd-36de-4ac8-b8dc-6b5d3f1e4be8")
>>> event.team.starting_formation
<FormationType.FOUR_FIVE_ONE: '4-5-1'>
>>> event.team.formations
TimeContainer[FormationType]({'P2T22:53': <FormationType.FOUR_FOUR_TWO: '4-4-2'>})

🚀 Other updates

• [StatsBomb] Added a CounterAttackQualifier by @DriesDeprest in #291
• [Wyscout v3] Estimate shot end coordinates by @fubininho in #320
• [Wyscout v3] Added support for extra time and penalties by @DriesDeprest in #351
• [Wyscout V3] Added position information for players by @DriesDeprest in #366
• [Wyscout V3] Added a PassQualifier(PassType.SHOT_ASSIST) by @DriesDeprest in #347
• [Stats Perform - Event] Infer ball state from previous event by @DriesDeprest in #341
• [Stats Perform - Event] Correct deflected pass end coordinates and result by @DriesDeprest in #311
• [Stats Perform - Event] Added formation and lineup changes by @DriesDeprest in #333 and #361
• Enriched metadata with date, game_week, game_id and officials by @SportsDynamicsDS in #340 and @UnravelSports in #371

🪲 Fixes

• Fix common bug in parsing of UTC datetimes by @probberechts in #373
• [Stats Perform - Event] Fix creation of goalkeeper events for event type 10/Save when an outfield player blocks a shot (qualifier 94) by @DriesDeprest in #335
• [Stats Perform - Tracking] Recognize referee player type and handle accordingly by @DriesDeprest in #357
• [Stats Perform - Tracking] Support frames with no player data by @DriesDeprest in #349
• [Stats Perform - Tracking] Handle missing end period for abandoned matches by @DriesDeprest in #355
• [SkillCorner] Support renaming "time" → "timestamp" by @UnravelSports in #338
• [Tracab] Support new meta data format by @UnravelSports in #353
• [Wyscout v3] Fix location for blocked crosses by @DriesDeprest in #343
• Use positions in get_player_by_position by @DriesDeprest in #342

👷 Refactoring

• Remove dateutil dependency by @probberechts in #373
• [SkillCorner] Remove numpy dependency by @probberechts in #375

🚨 Testing

• [Wyscout v3] Use publicly available Wyscout v3 event data in tests by @DriesDeprest in #350

👋 New Contributors

• @SportsDynamicsDS made their first contribution in #340
• @fubininho made their first contribution in #320

Full Changelog: v3.15.0...v3.16.0

v3.15.0

What's Changed

• Redo of #PR215 by @UnravelSports in #278
• Fix Wyscout orientation by @DriesDeprest in #279
• [Opta] Fix datatype of score by @probberechts in #286
• [Opta] Refactor tests by @probberechts in #289
• [Opta] Add BALL_STATE flag by @probberechts in #287
• [Opta] Fix F24 timestamp parsing by @probberechts in #288
• [Metrica] Fix metadata after transform by @probberechts in #290
• Fix transform orientation by @probberechts in #190
• Add support for JSON Tracab data by @DriesDeprest in #295
• Add shot assist to data model and fix Opta & StatsBomb deserializers accordingly by @DriesDeprest in #281
• Add pressure event to data model & StatsBomb parser by @DriesDeprest in #292
• Uniform implementation of timestamps by @probberechts in #294
• Upgrade MkDocs to version 1.5.3 by @JanVanHaaren in #303
• Upgrade GitHub Actions to latest versions by @JanVanHaaren in #304
• Accurate transformation of pitch dimensions by @probberechts in #297
• Add broken test for issue 305 by @koenvo in #306
• [Tracab] Parse xml meta information by @DriesDeprest in #300
• Remove Python3.7 support, add Python 3.12 to tests by @koenvo in #318
• Opta Incomplete / Live F7 missing Result tag fix by @UnravelSports in #322
• [Wyscout v3] add parsing of carry event by @DriesDeprest in #323
• [StatsPerform] Bugfixes for tracking data (MA25) + Support for event data (MA3) by @probberechts in #310
• Fix StatsBomb create_periods by @DriesDeprest in #313
• [IO] Improved IO with support for reading data from compressed files by @probberechts in #308
• Time-based positions + MinutedPlayed Aggregator by @koenvo in #326
• Don't use deprecated Player.position in tests by @koenvo in #327
• [Opta] Allow missing value for qualifier 210 by @probberechts in #328
• [Opta] Set bodypart=head for flick-ons by @probberechts in #329
• Fix for older/incomplete/other versions of Tracab Meta data files by @UnravelSports in #336
• [StatsPerform] Fix origin and vertical orientation of SportVU by @DriesDeprest in #345
• Add GH workflows for release by @koenvo in #348

Full Changelog: v3.14.0...v3.15.0

v3.14.0

What's Changed

• Add SetPieceQualifiers for StatsBomb Shot event by @probberechts in #223
• Add CardQualifiers for StatsBomb FoulCommited event by @probberechts in #221
• Run build docs by @koenvo in #231
• Fixing epts metrica loader when score is not on the metadata file by @jcnunezmoreno in #227
• Fix Bodypart qualifiers in StatsBomb clearance event by @probberechts in #228
• Add own goals in StatsBomb deserializer by @probberechts in #229
• Add InterceptionEvent by @MKlaasman in #230
• Add Opta shot result coordinates by @probberechts in #233
• Fix Wyscout deserialization of teams and players by @probberechts in #235
• Fix sportec current by @koenvo in #217
• Add StatsBomb shot result coordinates by @probberechts in #232
• Recognize take on event for Wyscout by @DriesDeprest in #238
• Fix multiple pass qualifiers per pass event by @DriesDeprest in #241
• Add tackle as duel type and recognize StatsPerform challenge event by @DriesDeprest in #242
• Fix Wyscout v2 set-piece qualifiers by @probberechts in #245
• Use new Wyscout open data format. by @koenvo in #248
• Support JSON meta data in Stats Perform tracking data deserializer by @JanVanHaaren in #255
• Remove duplicate Metrica set-piece events by @probberechts in #264
• Add artificial formation change event in Wyscout deserializer by @DriesDeprest in #250
• Estimate Wyscout v2 shot result coordinates by @probberechts in #246
• Fix shot end coordinates for Opta deserializer by @probberechts in #247
• Fix receiver_coordinates of passes for Wyscout v2 by @probberechts in #259
• Fix GoalKeeperActionType.SAVE coordinates for Wyscout v2 by @probberechts in #260
• Refactor StatsBomb deserializer by @probberechts in #262
• Implement GoalkeeperActionType.PICK_UP and GoalkeeperActionType.CLAIM for StatsBomb by @probberechts in #224
• Add shot body part qualifiers for Wyscout v2 by @probberechts in #258
• Add Opta support for extra time & penalty shootouts by @DriesDeprest in #263
• Fix FoulComitted + Card for Wyscout v2 by @probberechts in #261
• Revert changes to duel parsing logic in Opta deserializer by @JanVanHaaren in #273

Full Changelog: v3.13.0...v3.14.0

v3.13.0

• Add MiscontrolEvent (#207)
• Add GoalkeeperEvent (#196)

v3.12.0

• Add ClearanceEvent (#195)
• Fixed foot left/right typo in shot parsing for WyScout v3 (#197)
• Improvements to Opta and Wyscout deserializers (#198)
• Fix issue with automated tests on macos (#199)
• Add speed parsing for SecondSpectrum (#201)
• Add DuelEvent (#204)
• Sportec tracking (#208)

v3.11.0

• Fix datatype of SkillCorner metadata.periods (#189)
• Fix inputs of kloppy.helpers.transform (#186)
• Refactor pathlib tests (#193)
• StatsPerform deserializer (#191)
• Allow chaining of operators on a Dataset (filter + map) (#183)
• Opta remove deleted (#182)

v3.10.0

• Add support for corner shots (#176)
• Fix S3Adapter.read_to_stream (#179)
• Add pandas pyarrow support + better performance on to_df (#180)

v3.9.0

• Wyscout V3 deserializer (#170)

v3.8.0

• Fix for Incorrect home/away mapping in Statsbomb metadata (#174)
• Added extra formations (#166)
• Set correct orientation for Metrica EPTS (#168)
• Add polars support (#172)

Important changes:

• to_pandas is deprecated, to_df should be used. to_df is now a method on all Dataset types (event, tracking and code), and accepts an additional engine keyword argument that can be polars or pandas. The default value is pandas but can be changed using the config variable dataframe.engine

v3.7.1

• Refactor open_as_file to also accept Path inputs (#165)