SportVisionX

Sport Data Crawler & Championship Insights

Usage

To run the data crawler, use the following command:

python -m scripts.crawl_data --leagues leagues_data\basketball\leagues.txt --seasons leagues_data\basketball\seasons.txt --out_dir .results

You can create custom input files for the leagues and seasons by using the example files provided in the leagues_data/basketball folder as templates. Once you have customized these files according to your needs, pass their paths as arguments to the script.

Important: When you run the script, you will be prompted to select a sport from a list. Use the arrow keys to navigate and choose the appropriate sport. This selection is crucial because the primary basketball league in Spain is called ACB, while the primary football league in Spain is called LaLiga. Choosing the wrong sport may lead to incorrect data or no data at all being collected.

To run the data analyser, use the command from bellow:

python -m scripts.analyse_data --sport_dir .results\basketball --outfile .results\stats.txt 

At this moment, the script performs the following tasks:

• Scans all files found within the .results\basketball directory (e.g., 2022-2023\spain-acb.csv, 2021-2022\france-lnb.csv).
• Calculates the number of victories, defeats, and draws that the top 3 teams have against the bottom 3 teams based on the standings at a specific point in time:
  • Given a predefined stabilization round (e.g., round 8), the script computes a live leaderboard before each round.
  • For the 9th round, the analyzer:
    • Computes the standings with matches played up to and including round 9.
    • Identifies the top 3 teams.
    • Identifies the bottom 3 teams.
    • Checks if any top team has played against a bottom team and records the match outcome.
  • Repeats the above process for each round until the season is completed.
  • Merges the results into a dictionary for further analysis.
• Displays the results by season and championship.
• At the end, an overall summary of statistics is generated as a comprehensive overview.

Terminology

Stabilization round = A round in which the leaderboard stabilizes, meaning that the top-performing teams consistently occupy the upper positions, while the under-performing teams settle at the bottom. Typically, after the stabilization round, it becomes clearer which teams are likely contenders for the championship and which teams will be fighting to avoid relegation.

first k teams = given a live-standing, the first k teams that have the highest win_rate

last k teams = given a live-standing, the first k teams that have the lowest win_rate

Synonyms:

first k teams = top k teams = best k teams

last k teams = bottom k teams = worst k teams