Repolode
Submit
ramirobentes

ramirobentes/nbadatar

R package that loads NBA play-by-play, possession and lineup data for 30 seasons from Parquet files.

View on GitHubWebsite
Stars
10
Forks
0
Open issues
0
Last commit
last month

What is it?

nbadatar is an R package for loading NBA play-by-play, possession and lineup data. It covers 30 seasons, from 1996-97 through 2025-26, for both the regular season and the playoffs, and the current season is refreshed daily.

The package wraps functions such as load_pbp(), load_possessions() and load_lineup_stats(), which accept one or several seasons and a season_type argument for playoff data. The underlying files are hosted as Parquet on GitHub. Downloads are cached for the rest of the R session, and clear_cache() forces a fresh download when the current season's files change.

Because NBA data feeds changed over the years, some columns exist only for part of the range; missing values appear as NA in the affected files.

Key features

  • 01Loads play-by-play, possession and lineup tables with one function each.
  • 02Covers 30 seasons for both regular season and playoffs.
  • 03Accepts multiple seasons in a single call.
  • 04Caches downloads within an R session and offers clear_cache() for refreshes.
  • 05Current-season files are updated daily.

Use cases

  • Analyzing NBA play-by-play events in R with historical seasons.
  • Studying lineup performance and possession-level metrics across seasons.
  • Building playoff-specific models or reports from 2023 onward.
  • Tracking the current NBA season with daily-refreshed data.

Quick start

  1. 1

    Install the package from GitHub with pak

    pak::pak("ramirobentes/nbadatar")
  2. 2

    Load a season of play-by-play data in R

    pbp <- load_pbp(2025)

Things to know

  • Data is hosted in Parquet files on GitHub, so loading depends on that external repository.
  • Some columns exist only for part of the 1996-97 to 2025-26 range and are NA elsewhere.

In collections

Data science courses & tools

Topics

#nba#basketball#sports-data#parquet#data-analysis

FAQ

What is nbadatar?
R package that loads NBA play-by-play, possession and lineup data for 30 seasons from Parquet files. nbadatar is an R package for loading NBA play-by-play, possession and lineup data. It covers 30 seasons, from 1996-97 through 2025-26, for both the regular season and the playoffs, and the current season is refreshed daily.
Is nbadatar free to use? What license does it have?
nbadatar is open source under the Other license. Check the license terms before using it in commercial products.
Is nbadatar still maintained?
Updated within 6 months. The last commit to nbadatar was on Oct 1, 2026.
What can I use nbadatar for?
Analyzing NBA play-by-play events in R with historical seasons. Studying lineup performance and possession-level metrics across seasons. Building playoff-specific models or reports from 2023 onward. Tracking the current NBA season with daily-refreshed data.
How do I install nbadatar?
Install the package from GitHub with pak: pak::pak("ramirobentes/nbadatar") Load a season of play-by-play data in R: pbp <- load_pbp(2025)
Where can I get nbadatar?
The source code and installation instructions are on GitHub: https://github.com/ramirobentes/nbadatar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects