March madness predictor. Bring your own game winning prediction algorithm and hope for the best library and get a bracket printed out with the winners, along with a score for the final game.
Only data included in the official NCAA bracket will be provided. The following data points are included:
Additional data such as national rankings or seasonal statistics are not included as part of the main library, but should be implemented as part of a concrete strategy.
Teams in the first four have their region marked as <REGION>-Playoff
along
with the regional rank they're competing for.
For example, this is a sample of the 2022 bracket data used as test data:
Team Name,Region,Regional Rank,Wins,Losses
Rutgers,West-Playoff,11,18,13
Notre Dame,West-Playoff,11,22,10
Texas Southern,Midwest-Playoff,16,18,12
Texas A&M CC,Midwest-Playoff,16,23,11
Wright St.,South-Playoff,16,21,13
Bryant,South-Playoff,16,22,9
Wyoming,East-Playoff,12,25,8
Indiana,East-Playoff,12,20,13
Gonzaga,West,1,26,3
Georgia St.,West,16,18,10
Boise St.,West,8,27,7
Memphis,West,9,21,10
Uconn,West,5,23,9
New Mexico St.,West,12,26,6
Arkansas,West,4,25,8
Vermont,West,13,28,5
Alabama,West,6,19,3
Texas Tech,West,3,25,9
...
Implement a class that inherits from the IStrategy
interface defined in
istrategy.py.
Example strategies can be found in
gamewinner/strategies/
(i.e. the classic
BestRankWins).
The class has 4 main methods:
prepare(teams: dict[str,Team]) -> None
adjust(teams: dict[str,Team]) -> None
pick(team1: Team, team2: Team) -> tuple[Team, Team]
predict_score(winner: Team, loser: Team) -> tuple[int, int]
Once you've got your strategy figured out, printing a sample bracket is trivial.
Dependencies:
$ python -m pip install poetry
$ poetry install
From there, invoke the cli:
poetry run play --help
#
# Usage: play [OPTIONS]
#
#╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
#│ * --strategy TEXT strategy you want to use [default: None] [required] │
#│ --year INTEGER year you want to use [default: 2023] │
#│ --printer TEXT printer to use [default: colortext] │
#│ --help Show this message and exit. │
#╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
#
Dependencies:
No python toolchain is needed here. Simply run make docker
and generate
brackets for every strategy. Files will be created in the generated/
directory.
$ make docker
# ...
$ ls generated/
# BestRankWins-2024-basic.txt Rocky-2024-basic.txt TheCuts23Frozen-2024-basic.txt
# Chillz-2024-basic.txt SlothfireSteadiest-2024-basic.txt TheOwl-2024-basic.txt
# DoctorLizard-2024-basic.txt SlothfireSteady-2024-basic.txt TheWhiteWhale-2024-basic.txt
# FireWaterFireWater-2024-basic.txt SlothfireSteadyBayz-2024-basic.txt Vanilla-2024-basic.txt
# KillerChillz-2024-basic.txt TheCuts23-2024-basic.txt WorstRankWins-2024-basic.txt
# MrFreeze-2024-basic.txt TheCuts23DumBayz-2024-basic.txt
That's it. Good luck!
Special thanks to Vulfpeck for the name inspiration.