Skip to main content

WBB dataset loaders — Other

load_wbb_pbp​

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

Returns​

col_nametypedescription
game_play_numberInt32Game play number
idInt64Unique play identification number
sequence_numberInt32Sequence number representing a shot-possession (V3 PBP).
type_idInt32Type identifier (numeric).
type_textStringPlay type text, passed through verbatim from ESPN. ESPN labels the free-throw play type "MadeFreeThrow" for made AND missed free throws; filter makes vs. misses with scoring_play, not type_text.
textStringText description of the play / record.
away_scoreInt32Away team's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
home_scoreInt32Home team's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
period_numberInt32Numeric period (1-4 for quarters; 5+ for OT).
period_display_valueStringPeriod display label (e.g. '1st Quarter', 'OT').
clock_display_valueStringGame clock display string (e.g. '8:32').
scoring_playBooleanTRUE if the play resulted in points scored.
score_valueInt32Point value of the attempt (1 / 2 / 3), carried even on misses (a missed free throw still shows 1); use scoring_play to identify points actually scored.
wallclockStringWallclock.
shooting_playBooleanTRUE if the play was a shooting attempt.
coordinate_x_rawFloat64X coordinate as returned by the API before any adjustment.
coordinate_y_rawFloat64Y coordinate as returned by the API before any adjustment.
points_attemptedInt32Point 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_descriptionStringShortened version of ESPN's play description text, without score context.
team_idInt32Unique team identifier.
athlete_id_1Int32Primary athlete identifier (e.g. shooter).
athlete_id_2Int32Secondary athlete identifier (e.g. assister / fouler).
game_idInt32Unique game identifier.
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
season_typeInt32Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_idInt32Unique identifier for the home team.
home_team_nameStringHome team name.
home_team_mascotStringHome team mascot.
home_team_abbrevStringHome team three-letter abbreviation.
home_team_name_altStringAlternate versions of the home team abbreviation
away_team_idInt32Unique identifier for the away team.
away_team_nameStringAway team name.
away_team_mascotStringAway team mascot.
away_team_abbrevStringAway team three-letter abbreviation.
away_team_name_altStringAlternate versions of the away team abbreviation
game_spreadFloat64Game spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
home_favoriteBooleanLogical (TRUE/FALSE) indicating whether the home team is favored
game_spread_availableBooleanLogical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first
home_team_spreadFloat64The game spread with respect to the home team
qtrInt32Quarter of the game
timeStringTime left within the period
clock_minutesInt32Clock minutes split from seconds for developer convenience
clock_secondsInt32Clock seconds split from minutes for developer convenience
home_timeout_calledBooleanFlag set on plays where a timeout was charged to the home team.
away_timeout_calledBooleanFlag set on plays where a timeout was charged to the away team.
halfInt32Half of the game
game_halfInt32Half of the game
lag_qtrInt32A lag column on the quarter
lead_qtrInt32A lead column on the quarter
lag_halfInt32A lag column on the half
lead_halfInt32A lead column on the half
start_quarter_seconds_remainingInt32Quarter seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_half_seconds_remainingInt32Game half seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_game_seconds_remainingInt32Game seconds remaining at the start of the play (''')
end_quarter_seconds_remainingInt32Quarter seconds remaining at the end of the play (''')
end_half_seconds_remainingInt32Game half seconds remaining at the end of the play (''')
end_game_seconds_remainingInt32Game seconds remaining at the end of the play (''')
periodInt32Period of the game (1-4 quarters; 5+ for OT).
coordinate_xFloat64X coordinate on the court (half-court layout).
coordinate_yFloat64Y coordinate on the court (half-court layout).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
espn_home_wpFloat64ESPN's own published win probability for the home team (0-1), carried through unchanged.
espn_tie_percentageFloat64ESPN's published tie probability; present in the feed but always 0.0 in the published asset.
espn_away_wpFloat64ESPN's own published win probability for the away team (0-1), carried through unchanged.
athlete_name_1StringDisplay name of the first athlete in the ESPN play participants (e.g., the shooter on a shot attempt).
athlete_name_2StringDisplay name of the second athlete in the ESPN play participants (e.g., the assisting player), when present.
athlete_name_3StringDisplay name of the third athlete in the ESPN play participants, when present.
score_sourceStringWhere this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair. Select it by name: it is the play-by-play builder's last column, but a release can carry columns after it.
pregame_home_probFloat64Model's pre-game win probability for the home team (0-1), constant within a game. Present only on assets published with the WP model (2012-13 onward); absent on earlier seasons (rules/wbb.yaml#wbb-2013-pbp-wp-columns).
home_win_probFloat64
load_wbb_pbp(seasons=2024)

load_wbb_ratings​

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

Returns​

col_nametypedescription
seasonInt64Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
team_idStringUnique team identifier.
adj_oFloat64Adj o.
adj_dFloat64Adj d.
adj_emFloat64Adj em.
adj_tempoFloat64Opponent-adjusted tempo in possessions per 40 minutes, produced by the same fixed-point adjustment as the efficiencies applied to game possessions under the additive model poss = tempo_i + tempo_j minus the league baseline.
raw_oFloat64Raw o.
raw_dFloat64Raw d.
gamesInt64Games played.
rankInt64Rank.
adj_em_zFloat64Within-season z-score of adj_em, computed as adj_em minus the season mean divided by the season standard deviation over every team in the frame, so it is mean 0 and standard deviation 1 per season.
adj_o_blendFloat64Adjusted offensive efficiency with the season sim's preseason prior blended in: the same fixed point as adj_o, each Division I team shrunk toward last season's regressed rating as if it had played prior_games extra games at it.
adj_d_blendFloat64Adjusted defensive efficiency with the preseason prior blended in, on the same basis as adj_o_blend (lower is better).
adj_em_blendFloat64adj_o_blend - adj_d_blend: the adjusted efficiency margin with the preseason prior, the rating the pregame projection uses. A team with g games is rated about g / (g + prior_games) on this season.
rank_blendInt64Dense rank of adj_em_blend within the season (1 = best).
prior_gamesFloat64The preseason prior's weight in games (4 men, 3 women, fit by tools/fit_preseason_prior.py); 0 when the previous season is not released, and the blend then equals the raw rating. The five blend columns are in season assets built after 2026-11-13 (#1193); an asset published before then lacks them until the producer rebuilds it.
load_wbb_ratings(seasons=2025)

load_wbb_game_rosters​

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

Returns​

col_nametypedescription
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
game_idInt32Unique game identifier.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
home_awayStringGame venue label ('home' or 'away').
athlete_idInt32Unique athlete identifier (ESPN).
athlete_uidStringESPN athlete UID (universal identifier).
athlete_guidStringESPN athlete GUID.
athlete_display_nameStringAthlete display name (full).
athlete_short_nameStringAthlete short display name.
athlete_first_nameString
athlete_last_nameString
athlete_jerseyStringAthlete jersey number.
athlete_positionStringAthlete position.
athlete_headshotStringURL of the player's ESPN headshot image on a.espncdn.com, whose filename is the athlete_id; null when ESPN publishes no headshot for that player.
starterBooleanTRUE if the player was in the starting lineup; FALSE otherwise.
did_not_playBooleanTRUE if the player did not appear in the game.
activeBooleanTRUE if the row represents an active record (player / team / season).
ejectedBooleanTRUE if the player was ejected from the game.
reasonStringReason.
load_wbb_game_rosters(seasons=2026)

load_wbb_officials​

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

Returns​

col_nametypedescription
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
game_idInt32Unique game identifier.
official_idInt32Unique official / referee identifier.
official_uidStringESPN's globally unique resource identifier for the official, read from the core-api items[] uid key; that payload never ships it, so the column is null for every published row.
official_full_nameStringESPN's fullName for the official, falling back to displayName when fullName is absent; ESPN sometimes ships it with a middle initial or a doubled internal space, so it is not simply first plus last name.
official_display_nameStringESPN's displayName for the official, which is identical to official_full_name in every published row of the released data.
official_first_nameStringThe official's given name as ESPN splits it out separately from the full name, excluding any middle initial that appears in official_full_name.
official_last_nameStringThe official's surname as ESPN splits it out; joined to official_first_name it reconstructs roughly 98 percent of official_full_name values, the rest differing by middle initials or spacing.
official_orderInt32ESPN's 1-based sequence of the official within that game's crew listing, unique within a game and running 1 to 3 for the standard three-person crew.
position_nameStringListed roster position ('Guard', 'Forward', 'Center').
position_display_nameStringPosition display name.
load_wbb_officials(seasons=2026)

load_wbb_rosters​

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

Returns​

col_nametypedescription
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
athlete_idStringUnique athlete identifier (ESPN).
uidStringESPN UID string.
guidStringStable cross-league team GUID.
full_nameStringPlayer's full name.
display_nameStringDisplay name.
short_nameStringShort display name.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
jerseyStringJersey number worn by the player.
position_abbreviationStringPosition abbreviation ('G' / 'F' / 'C').
position_nameStringListed roster position ('Guard', 'Forward', 'Center').
position_idStringUnique position identifier.
heightStringPlayer height (string e.g. '6-2' or inches).
weightStringPlayer weight in pounds.
ageStringPlayer age (in years).
date_of_birthStringDate of birth (YYYY-MM-DD).
birth_place_cityStringBirth place city.
birth_place_stateStringBirth place state.
birth_place_countryStringBirth place country.
experience_yearsStringExperience years.
experience_display_valueStringExperience display value.
headshot_hrefStringHeadshot image URL.
headshot_altStringAlternative-text label for the headshot.
link_webStringWeb link / URL.
status_idStringStatus identifier.
status_nameStringStatus label.
status_typeStringStatus type.
load_wbb_rosters(seasons=2026)

load_wbb_shots​

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

Returns​

col_nametypedescription
game_idInt32Unique game identifier.
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
period_numberInt32Numeric period (1-4 for quarters; 5+ for OT).
clock_display_valueStringGame clock display string (e.g. '8:32').
team_idInt32Unique team identifier.
athlete_id_1Int32Primary athlete identifier (e.g. shooter).
athlete_id_2Int32Secondary athlete identifier (e.g. assister / fouler).
type_idInt32Type identifier (numeric).
type_textStringDisplay text for the type field.
scoring_playBooleanTRUE if the play resulted in points scored.
score_valueInt32Point value of the play (2 / 3 / 1).
coordinate_xFloat64X coordinate on the court (half-court layout).
coordinate_yFloat64Y coordinate on the court (half-court layout).
coordinate_x_rawFloat64X coordinate as returned by the API before any adjustment.
coordinate_y_rawFloat64Y coordinate as returned by the API before any adjustment.
athlete_name_1StringDisplay name of the shooter credited on the attempt in ESPN's play participants.
athlete_name_2StringDisplay name of the second athlete tied to the attempt (typically the assister), when present.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_mascotStringMascot/nickname of the shooting team from ESPN's team record.
team_abbrevStringAbbreviation for team.
load_wbb_shots(seasons=2026)

load_wbb_standings​

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

Returns​

col_nametypedescription
seasonInt32Season as its 4-digit ending year (integer; 2026 = 2025-26). A 'YYYY-YY' string is not accepted.
group_idInt32ESPN group id.
group_nameString
group_abbreviationString
group_short_nameStringShort display name of the conference or division grouping the row belongs to.
team_idInt32Unique team identifier.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationStringTeam city or location string.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
stat_nameStringInternal stat key.
stat_display_nameStringStat display name.
stat_short_display_nameString
stat_descriptionStringESPN's longer wording for the standings stat, for example Overall Record for the Team Season Record entry and Current Streak for Streak; null for stats ESPN ships without one, such as vs AP Top 25.
stat_abbreviationStringESPN's abbreviation for the standings stat, such as GB, OPP PPG or VS CONF; always populated and matching stat_short_display_name for about 90 percent of rows.
stat_typeStringStat type code (e.g. "win", "loss").
display_valueStringDisplay-formatted value.
valueFloat64Numeric or string value field.
load_wbb_standings(seasons=2026)

load_wbb_groups​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_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. wbb: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_nametypedescription
leagueStringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idStringSDV 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.
levelStringHierarchy level of the group: "league", "subdivision", "conference" or "division".
first_seasonInt32First season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
last_seasonInt32Last season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
notesStringBuilder notes on the group: the lineage decisions behind its group_id and any source caveats.
load_wbb_groups()

load_wbb_group_seasons​

Release: wbb_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wbb_groups/wbb_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_nametypedescription
leagueStringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idStringSDV 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.
seasonInt32Season the row describes (ENDING year: 2025 = the 2024-25 season).
levelStringHierarchy level of the group: "league", "subdivision", "conference" or "division".
nameStringFull name of the group as of that season -- the label in use then, not today's name.
short_nameStringShort display name of the group as of that season.
abbreviationStringAbbreviation of the group as of that season.
parent_group_idStringgroup_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_teamsInt32Number of member teams in the group that season.
load_wbb_group_seasons()

load_wbb_group_aliases​

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

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (espn, 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_nametypedescription
leagueStringLeague code of the table ("wbb"); the prefix of every group_id in it.
group_idStringSDV 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.
sourceStringSource that uses this label or id (in this table: espn, ncaa, sdv); "sdv" marks SDV's own labels.
source_idStringThe 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_kindStringKind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
valueStringThe label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_fromInt32First season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded.
valid_toInt32Last season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded (still in use).
load_wbb_group_aliases()