MBB dataset loaders — Other

load_mbb_pbp

Release: espn_mens_college_basketball_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_pbp/play_by_play_{season}.parquet

Returns

col_name	type	description
game_play_number	Int32	Sequential play number within the game.
id	Int64	Id.
sequence_number	Int32	Sequence number representing a shot-possession (V3 PBP).
type_id	Int32	Type identifier (numeric).
type_text	String	Display text for the type field.
text	String	Text description of the play / record.
away_score	Int32	Away team score at the time of the play.
home_score	Int32	Home team score at the time of the play.
period_number	Int32	Numeric period (1-4 for quarters; 5+ for OT).
period_display_value	String	Period display label (e.g. '1st Quarter', 'OT').
clock_display_value	String	Game clock display string (e.g. '8:32').
scoring_play	Boolean	TRUE if the play resulted in points scored.
score_value	Int32	Point value of the play (2 / 3 / 1).
team_id	Int32	Unique team identifier.
athlete_id_1	Int32	Primary athlete identifier (e.g. shooter).
wallclock	String	Wallclock.
shooting_play	Boolean	TRUE if the play was a shooting attempt.
points_attempted	Int32	Point value at stake on the shot attempt (3 for threes, 2 for other field goals, 1 for free throws), from the ESPN play type.
short_description	String	Shortened version of ESPN's play description text, without score context.
athlete_id_2	Int32	Secondary athlete identifier (e.g. assister / fouler).
game_id	Int32	Unique game identifier.
season	Int32	Season year.
season_type	Int32	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_id	Int32	Unique identifier for the home team.
home_team_name	String	Home team name.
home_team_mascot	String	Home team mascot.
home_team_abbrev	String	Home team three-letter abbreviation.
home_team_name_alt	String	Alternate home team name.
away_team_id	Int32	Unique identifier for the away team.
away_team_name	String	Away team name.
away_team_mascot	String	Away team mascot.
away_team_abbrev	String	Away team three-letter abbreviation.
away_team_name_alt	String	Alternate away team name.
game_spread	Float64	Game spread (signed; positive = home favored).
home_favorite	Boolean	TRUE if the home team is the betting favorite.
game_spread_available	Boolean	TRUE if a point spread was available.
home_team_spread	Float64	Home team's point spread.
half	Int32	Half of the game (1 or 2).
time	String	Time / clock value.
clock_minutes	Int32	Clock minutes split out for convenience.
clock_seconds	Int32	Clock seconds split out for convenience.
home_timeout_called	Boolean	True when the home team called a timeout on the play.
away_timeout_called	Boolean	True when the away team called a timeout on the play.
lag_period	Int32	Period number of the previous play in the same game (period_number shifted forward one row within game_id), and null on each game's first play.
lead_period	Int32	Period number of the next play in the same game (period_number shifted back one row within game_id), and null on each game's final play.
lag_half	Int32	A lag column on the half
lead_half	Int32	A lead column on the half
start_period_seconds_remaining	Int32	Seconds left in the current period when the play started, computed as 60 times the game clock minutes plus the seconds, so 1200 at the tip of each 20-minute half and 300 at the start of an overtime.
start_game_seconds_remaining	Int32	Seconds remaining in the game at the start of the play.
end_period_seconds_remaining	Int32	Seconds left in the period when the play ended.
end_game_seconds_remaining	Int32	Seconds remaining in the game at the end of the play.
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	Datetime(time_unit='us', time_zone='America/New_York')	Game start date/time (ISO 8601).
coordinate_x	Float64	X coordinate on the court (half-court layout).
coordinate_y	Float64	Y coordinate on the court (half-court layout).
coordinate_x_raw	Float64	X coordinate as returned by the API before any adjustment.
coordinate_y_raw	Float64	Y coordinate as returned by the API before any adjustment.
athlete_name_1	String	Display name of the first athlete in the ESPN play participants (e.g., the shooter on a shot attempt).
athlete_name_2	String	Display name of the second athlete in the ESPN play participants (e.g., the assisting player), when present.
athlete_name_3	String	Display name of the third athlete in the ESPN play participants, when present.
media_id	String	Media identifier (video / image).
pregame_home_prob	Float64	Model's pre-game win probability for the home team (0-1), constant within a game.
home_win_prob	Float64	Home win probability - pre-game prediction (0-1).

load_mbb_pbp(seasons=2024)

load_mbb_schedule

Release: espn_mens_college_basketball_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_schedules/mbb_schedule_{season}.parquet

Returns

col_name	type	description
id	Int32	Id.
uid	String	ESPN UID string.
date	String	Date in YYYY-MM-DD format.
attendance	Float64	Reported attendance.
time_valid	Boolean	Time valid.
neutral_site	Boolean	Neutral site.
conference_competition	Boolean	Conference competition.
play_by_play_available	Boolean	Whether play-by-play data is available.
recent	Boolean	Recent.
start_date	String	Start date (YYYY-MM-DD).
broadcast	String	Broadcast information string.
highlights	String	Game highlight urls.
notes_type	String	Notes type.
notes_headline	String	Notes headline.
broadcast_market	String	Broadcast market label (e.g. 'national', 'home').
broadcast_name	String	Broadcast name.
type_id	Int32	Type identifier (numeric).
type_abbreviation	String	Type abbreviation.
venue_id	Int32	Unique venue identifier.
venue_full_name	String	Venue full name.
venue_address_city	String	Venue address city.
venue_address_state	String	Venue address state / region.
venue_indoor	Boolean	TRUE if the venue is indoors.
status_clock	Float64	Status clock.
status_display_clock	String	Status display clock.
status_period	Float64	Status period.
status_type_id	Int32	Unique identifier for status type.
status_type_name	String	Status type name.
status_type_state	String	Status type state.
status_type_completed	Boolean	Status type completed.
status_type_description	String	Status type description.
status_type_detail	String	Status type detail.
status_type_short_detail	String	Status type short detail.
format_regulation_periods	Float64	Format regulation periods.
home_id	Int32	Unique identifier for home.
home_uid	String	Home team's uid.
home_location	String	Home team's location.
home_name	String	Home name.
home_abbreviation	String	Home team's abbreviation.
home_display_name	String	Home display name.
home_short_display_name	String	Home short display name.
home_color	String	Color code (hex) for home.
home_alternate_color	String	Color code (hex) for home alternate.
home_is_active	Boolean	Home team's is active.
home_venue_id	Int32	Unique identifier for home venue.
home_logo	String	Home team logo URL.
home_conference_id	Int32	Unique identifier for home conference.
home_score	Int32	Home team score at the time of the play.
home_winner	Boolean	Home team's winner.
home_current_rank	Float64	Poll ranking ESPN listed for the home team at game time (unranked teams carry a sentinel value).
home_linescores	String	Period-by-period scores for the home team as a delimited string from ESPN's schedule feed.
home_records	String	Record strings (overall and split records) for the home team from ESPN's schedule feed.
away_id	Int32	Unique identifier for away.
away_uid	String	Away team's uid.
away_location	String	Away team's location.
away_name	String	Away name.
away_abbreviation	String	Away team's abbreviation.
away_display_name	String	Away display name.
away_short_display_name	String	Away short display name.
away_color	String	Color code (hex) for away.
away_alternate_color	String	Color code (hex) for away alternate.
away_is_active	Boolean	Away team's is active.
away_venue_id	Int32	Unique identifier for away venue.
away_logo	String	Away team logo URL.
away_conference_id	Int32	Unique identifier for away conference.
away_score	Int32	Away team score at the time of the play.
away_winner	Boolean	Away team's winner.
away_current_rank	Float64	Poll ranking ESPN listed for the away team at game time (unranked teams carry a sentinel value).
away_linescores	String	Period-by-period scores for the away team as a delimited string from ESPN's schedule feed.
away_records	String	Record strings (overall and split records) for the away team from ESPN's schedule feed.
game_id	Int32	Unique game identifier.
season	Int32	Season year.
season_type	Int32	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
away_non_div1_team	Boolean	ESPN's non-Division I flag for the away team: True when the away team is not a Division I program (a lower-division or exhibition opponent, which also carries no away_conference_id); null, not False, for every Division I team. Sparse -- a handful of games per season.
status_type_alt_detail	String	Status type alt detail.
tournament_id	Int32	ESPN tournament identifier.
groups_id	Int32	Unique identifier for groups.
groups_name	String	Groups name.
groups_short_name	String	Groups short name.
groups_is_conference	Boolean	Groups is conference.
game_json	Boolean	Whether processed game JSON is available.
game_json_url	String	URL to the processed game JSON.
game_date_time	Datetime(time_unit='us', time_zone='America/New_York')	Game start date/time (ISO 8601).
game_date	Date	Game date (YYYY-MM-DD).
PBP	Boolean	Whether play-by-play data is available.
team_box	Boolean	Team box.
player_box	Boolean	Player box.

load_mbb_schedule(seasons=2024)

load_mbb_ratings

Release: mbb_ratings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_ratings/mbb_ratings_{season}.parquet

Returns

col_name	type	description
season	Int64	Season year.
team_id	String	Unique team identifier.
adj_o	Float64	Adj o.
adj_d	Float64	Adj d.
adj_em	Float64	Adj em.
adj_tempo	Float64	Opponent-adjusted possessions per 40 minutes, solved by the same fixed point as the efficiency ratings under the additive model that a game's pace is the two teams' tempos less the league baseline; it averages about 71 in 2025.
raw_o	Float64	Raw o.
raw_d	Float64	Raw d.
games	Int64	Games played.
rank	Int64	Rank.
adj_em_z	Float64	Within-season z-score of adj_em, computed as adj_em minus the season mean divided by the season standard deviation, so each season is centered at zero with unit spread.

load_mbb_ratings(seasons=2025)

load_mbb_shots

Release: espn_mens_college_basketball_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_shots/shots_{season}.parquet

Returns

col_name	type	description
game_id	Int32	Unique game identifier.
season	Int32	Season year.
period_number	Int32	Numeric period (1-4 for quarters; 5+ for OT).
clock_display_value	String	Game clock display string (e.g. '8:32').
team_id	Int32	Unique team identifier.
athlete_id_1	Int32	Primary athlete identifier (e.g. shooter).
athlete_id_2	Int32	Secondary athlete identifier (e.g. assister / fouler).
type_id	Int32	Type identifier (numeric).
type_text	String	Display text for the type field.
scoring_play	Boolean	TRUE if the play resulted in points scored.
score_value	Int32	Point value of the play (2 / 3 / 1).
coordinate_x	Float64	X coordinate on the court (half-court layout).
coordinate_y	Float64	Y coordinate on the court (half-court layout).
coordinate_x_raw	Float64	X coordinate as returned by the API before any adjustment.
coordinate_y_raw	Float64	Y coordinate as returned by the API before any adjustment.
athlete_name_1	String	Display name of the shooter credited on the attempt in ESPN's play participants.
athlete_name_2	String	Display name of the second athlete tied to the attempt (typically the assister), when present.
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_mascot	String	Mascot/nickname of the shooting team from ESPN's team record.
team_abbrev	String	Abbreviation for team.

load_mbb_shots(seasons=2025)

load_mbb_standings

Release: espn_mens_college_basketball_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_standings/standings_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
group_id	String	ESPN group id.
group_name	String	Group name (conference / division).
group_abbreviation	String	Group abbreviation.
group_short_name	String	Abbreviated conference label ESPN prints in standings tables, such as ACC, Big Ten or Am. East, one value per group_id.
team_id	Int32	Unique team identifier.
team_uid	String	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location	String	Team city or location string.
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
stat_name	String	Stat key.
stat_display_name	String	Stat display name.
stat_short_display_name	String	Short human-readable stat name.
stat_description	String	ESPN's longer-form label for the standings statistic, which can differ from stat_display_name (streak is described as Current Streak and playoffSeed as Playoff Seed).
stat_abbreviation	String	Short code ESPN prints for the standings statistic in a table header, such as W, L, PCT, GB or STRK; it diverges from stat_short_display_name for playoff seed and the home and conference record rows.
stat_type	String	Stat type code (e.g. "win", "loss").
display_value	String	Display-formatted value.
value	Float64	Numeric or string value field.

load_mbb_standings(seasons=2025)

load_mbb_rosters

Release: espn_mens_college_basketball_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_rosters/rosters_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
team_id	Int32	Unique team identifier.
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
athlete_id	String	Unique athlete identifier (ESPN).
uid	String	ESPN UID string.
guid	String	Stable cross-league team GUID.
full_name	String	Player's full name.
display_name	String	Display name.
short_name	String	Short display name.
first_name	String	Player's first name.
last_name	String	Player's last name.
jersey	String	Jersey number worn by the player.
position_abbreviation	String	Position abbreviation ('G' / 'F' / 'C').
position_name	String	Listed roster position ('Guard', 'Forward', 'Center').
position_id	String	Unique position identifier.
height	String	Player height (string e.g. '6-2' or inches).
weight	String	Player weight in pounds.
age	String	Player age (in years).
date_of_birth	String	Date of birth (YYYY-MM-DD).
birth_place_city	String	Birth place city.
birth_place_state	String	Birth place state.
birth_place_country	String	Birth place country.
experience_years	String	Experience years.
experience_display_value	String	Experience display value.
headshot_href	String	Headshot image URL.
headshot_alt	String	Alternative-text label for the headshot.
link_web	String	Web link / URL.
status_id	String	Status identifier.
status_name	String	Status label.
status_type	String	Status type.

load_mbb_rosters(seasons=2025)

load_mbb_officials

Release: espn_mens_college_basketball_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_officials/officials_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
game_id	Int32	Unique game identifier.
official_full_name	String	Full name of the game official as published in ESPN's gameInfo officials list; in this release it is byte-identical to official_display_name on every row.
official_display_name	String	Display form of the official's name used by ESPN's game feed, which duplicates official_full_name for all 18,284 rows of the 2025 release.
official_position	String	ESPN's role label for the crew member, which is the constant Referee for every men's college basketball official in this release rather than a distinct crew chief or umpire designation.
official_position_id	Int32	ESPN's numeric code for the official's role, constant at 40 (Referee) across the entire men's college basketball officials release.
official_order	Int32	Position of the official within the game's listed officiating crew.

load_mbb_officials(seasons=2025)

load_mbb_game_rosters

Release: espn_mens_college_basketball_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_game_rosters/game_rosters_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
game_id	String	Unique game identifier.
team_id	Int32	Unique team identifier.
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
home_away	String	Game venue label ('home' or 'away').
athlete_id	Int32	Unique athlete identifier (ESPN).
athlete_uid	String	ESPN athlete UID (universal identifier).
athlete_guid	String	ESPN athlete GUID.
athlete_display_name	String	Athlete display name (full).
athlete_short_name	String	Athlete short display name.
athlete_first_name	String	Player first name; athlete_detail = TRUE only.
athlete_last_name	String	Athlete last name.
athlete_jersey	String	Athlete jersey number.
athlete_position	String	Athlete position.
athlete_headshot	String	URL of the player's ESPN headshot image, whose filename is the athlete_id (verified equal for all 190,365 non-null rows in 2025); null when ESPN publishes no photo for that player.
starter	Boolean	TRUE if the player was in the starting lineup; FALSE otherwise.
did_not_play	Boolean	TRUE if the player did not appear in the game.
active	Boolean	TRUE if the row represents an active record (player / team / season).
ejected	Boolean	TRUE if the player was ejected from the game.
reason	String	Reason.

load_mbb_game_rosters(seasons=2025)

load_mbb_schedule_crosswalk

Release: mbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_crosswalk/mbb_schedule_crosswalk_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
game_date	Date	Game date (YYYY-MM-DD).
home_espn_team_id	Int32	ESPN home team id (NA for bart-only rows).
away_espn_team_id	Int32	ESPN away team id (NA for bart-only rows).
espn_game_id	String	ESPN game id (NA for bart-only rows).
bart_muid	String	Torvik muid (NA for espn-only rows).
bart_team1	String	Torvik team1 name (NA for espn-only rows).
bart_team2	String	Torvik team2 name (NA for espn-only rows).
bart_winner	String	Torvik winner name (NA for espn-only rows).
kp_game_id	String	KenPom game id (NA unless kenpom enabled).
fox_game_id	String	Fox game id (NA placeholder).
yahoo_game_id	String	Yahoo game id (NA placeholder).
match_method	String	Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidence	Float64	Jaro-Winkler score or 1 for exact (NA if none).

load_mbb_schedule_crosswalk(seasons=2026)

load_mbb_groups

Release: mbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/mbb_groups.parquet

Coverage

One season-less file: one row per group lineage (the league, subdivisions, conferences, divisions) with the first and last season it had members. group_id is SDV's own id (e.g. mbb:big-east) and names a lineage: a rename that keeps continuity keeps the id, a new body gets a new one, and notes records each call. Seasons are the ENDING year (2025 = the 2024-25 season).

Returns

col_name	type	description
league	String	League code of the table ("mbb"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
level	String	Hierarchy level of the group: "league", "subdivision", "conference" or "division".
first_season	Int32	First season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
last_season	Int32	Last season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
notes	String	Builder notes on the group: the lineage decisions behind its group_id and any source caveats.

load_mbb_groups()

load_mbb_group_seasons

Release: mbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/mbb_group_seasons.parquet

Coverage

One season-less file: one row per group per season it existed, with its name, short name, abbreviation and parent group AS OF that season (never today's label applied to the past) and its member count. season is the ENDING year (2025 = the 2024-25 season).

Returns

col_name	type	description
league	String	League code of the table ("mbb"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
season	Int32	Season the row describes (ENDING year: 2025 = the 2024-25 season).
level	String	Hierarchy level of the group: "league", "subdivision", "conference" or "division".
name	String	Full name of the group as of that season -- the label in use then, not today's name.
short_name	String	Short display name of the group as of that season.
abbreviation	String	Abbreviation of the group as of that season.
parent_group_id	String	group_id one level up as of that season (division -> conference -> subdivision -> league); null at the top level or where no higher group applied that season.
n_teams	Int32	Number of member teams in the group that season.

load_mbb_group_seasons()

load_mbb_group_aliases

Release: mbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_groups/mbb_group_aliases.parquet

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (espn, kenpom, ncaa, sdv) uses for a group, each with the seasons it is valid for (valid_from / valid_to, inclusive; null = unbounded). Match a source's conference or division label here to reach group_id.

Returns

col_name	type	description
league	String	League code of the table ("mbb"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
source	String	Source that uses this label or id (in this table: espn, kenpom, ncaa, sdv); "sdv" marks SDV's own labels.
source_id	String	The source's own id for the group (ESPN group id, NCAA conf_id, CFBD id, MLB division id) when it has one; null otherwise.
name_kind	String	Kind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
value	String	The label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_from	Int32	First season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded.
valid_to	Int32	Last season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded (still in use).

load_mbb_group_aliases()