mbb_groups
Men's college basketball conference, division and subdivision reference.
26 seasons (2002–2027) · 60 assets · 1.8 MB · last asset written 2026-09-28
Upstream source: the league's membership source and every source's names and ids for its groups (see the build repo).
Season key. the ending year (2025 = 2024-25)
Note. A reference table, not observations. Four tables:
groups(one row per SDV group lineage,{league}:{slug}),group_seasons(each group's name, abbreviation and parent as of that season),group_aliases(every source's ids and names for a group, with validity windows) andteam_group_seasons(each team's subdivision, conference and division by season, one file per season). Historical names come from dated, cited rows: ESPN, stats.ncaa.org and CFBD all show today's names for past seasons. Schema: sdv-reference-dataCONTRACT.md.
Files in this release
| Format | Files | Name pattern |
|---|---|---|
csv |
30 | {dataset}_{season}.csv |
parquet |
30 | {dataset}_{season}.parquet |
This tag carries 4 distinct datasets under one release: mbb_team_group_seasons, mbb_groups, mbb_group_aliases, mbb_group_seasons.
Direct download (no auth, no API key):
https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/mbb_team_group_seasons_2027.parquet
How to load it
| Surface | Call |
|---|---|
| Python | from sportsdataverse.mbb import load_mbb_groupsload_mbb_groups() |
| Python | from sportsdataverse.mbb import load_mbb_group_seasonsload_mbb_group_seasons() |
| Python | from sportsdataverse.mbb import load_mbb_group_aliasesload_mbb_group_aliases() |
| Python | from sportsdataverse.mbb import load_mbb_team_group_seasonsload_mbb_team_group_seasons(seasons=[2027]) |
| R | hoopR::load_mbb_groups() |
| Any | pd.read_parquet("https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/...") — the assets are plain files on a public URL |
How it is produced
- Capture —
sdv-reference-data:fetch()insdv_reference/leagues/mbb.pysnapshots the sources intoraw/mbb/. - Build —
sdv-reference-data:scripts/pipeline/20_build_tables.sh mbb(offline, fromraw/and citedcurated/rows). - Publish —
scripts/pipeline/30_publish_releases.sh mbbin sdv-reference-data uploads the assets to this tag.
Automation
No scheduled automation is attached to this tag: it is refreshed on demand.
What depends on it
sportsdataverse-py—sportsdataverse.mbb.load_mbb_groups()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.mbb.load_mbb_group_seasons()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.mbb.load_mbb_group_aliases()reads this tag directly (API docs).sportsdataverse-py—sportsdataverse.mbb.load_mbb_team_group_seasons()reads this tag directly (API docs).hoopR—hoopR::load_mbb_groups()reads this tag directly.sportsdataverse-py— also read outside the loaders bymbb_crosswalk(models, scorers and feature builders).sportsdataverse-web— reads this tag in application code.
Part of SportsDataverse. Every release in this repository is a public, versioned data asset: the files are stable URLs you can read straight from R, Python, or anything that speaks HTTP. Issues with the data belong on the producing repository listed above; issues with a loader belong on that package's repository.