OptaLoader Whoscored parser about socceraction

[probberechts]

1. You have to store the WhoScored JSON files in a file structure that includes the competition ID, season ID and game ID. For example: ./data/2-2021/game_1234.json, ./data/2-2021/game_1235.json, ... where 2 is the competition ID, 2021 is the season ID, and 1234 and 1235 are the game IDs.

2. Create and OptaLoader instance

from socceraction.spadl.opta import OptaLoader

loader = OptaLoader(
    root="./data", 
    parser='whoscored',
    feeds={'whoscored': "{competition_id}-{season_id}/game_{game_id}.json"})

The feeds dict is a pattern that allows the loader to select the corresponding json files for a competition, season or game. It should correspond to the file structure above, where the IDs are replaced by the "{competition_id}", "{season-id}" and "{game_id}" keys.

3. Load data with

games = games(competition_id=2, season_id=2021)
players = loader.players(game_id=1234)
teams = loader.teams(game_id=1234)
events = loader.events(game_id=1234)

Some notes:

• The WhoScored JSON files do not contain data about the competitions, so you won't get any data from loader.competitions().
• The competition_id, season_id and game_id have to be integers. This changed in v1.0.1