nascaR.data (version 3.0.0)

load_series: Load NASCAR Series Data

Description

Downloads NASCAR series data from Cloudflare R2 as a parquet file. Uses two-tier caching (memory + disk) for performance. On first call, data is downloaded and cached locally. Subsequent calls return cached data instantly.

Usage

load_series(series = c("cup", "nxs", "truck"), refresh = FALSE)

Value

A data frame with 21 columns of race results: Season, Race, Track, Name, Length, Surface, Finish, Start, Car, Driver, Team, Make, Pts, Laps, Led, Status, S1, S2, S3, Rating, and Win.

Arguments

series

Character. The series to load. One of "cup", "nxs", or "truck".

refresh

Logical. If TRUE, bypass the cache and re-download from cloud storage. Default is FALSE.

Details

Why "nxs"?

NASCAR's NXS uses the sponsor-neutral identifier "nxs" rather than a sponsor name. The series has been sponsored by Busch (1984-2007), Nationwide (2008-2014), Xfinity (2015-2025), and O'Reilly Auto Parts (2026-present). Using "nxs" keeps the identifier stable across sponsor changes.

Caching

Data is cached in two tiers:

• Memory: Instant access within the current R session.

• Disk: Persists across sessions at the CRAN-approved location returned by tools::R_user_dir("nascaR.data", which = "cache").

Use refresh = TRUE to force a fresh download, or clear_cache() to remove all cached data.

See Also

series_data for column descriptions, clear_cache() for cache management, get_driver_info() for driver statistics.

Examples

# \donttest{
# Load Cup Series data (downloads on first call, cached after)
cup <- load_series("cup")

# Load NXS data
nxs <- load_series("nxs")

# Load Truck Series data
truck <- load_series("truck")

# Force re-download from cloud storage
cup <- load_series("cup", refresh = TRUE)
# }