Package 'nascaR.data'

Description

Clears the in-memory cache so the next call to load_series() will re-download from cloud storage. Also removes any leftover disk cache from previous package versions.

Usage

clear_cache()

Value

Invisibly returns NULL.

See Also

load_series() for data access.

Examples

## Not run: 
# Clear in-memory cache
clear_cache()

# Next call downloads fresh data
cup <- load_series("cup")

## End(Not run)

Description

Search for a driver by name and return career statistics. Supports partial names, typos, and case-insensitive input via the built-in fuzzy matching engine.

Usage

get_driver_info(driver, series = "all", type = "summary", interactive = TRUE)

Arguments

Value

A tibble of driver statistics (format depends on type), or invisible(NULL) if no match is found.

See Also

get_team_info(), get_manufacturer_info(), load_series(), series_data

Examples

# Career summary across all series
get_driver_info("Christopher Bell")

# Season-by-season Cup data
get_driver_info(
  "Christopher Bell",
  series = "cup",
  type = "season"
)

Description

Search for a manufacturer by name and return performance statistics. Uses fuzzy matching to handle partial names, typos, and case-insensitive searches.

Usage

get_manufacturer_info(
  manufacturer,
  series = "all",
  type = "summary",
  interactive = TRUE
)

Arguments

Value

A tibble of manufacturer statistics (format depends on type), or invisible(NULL) if no match is found.

See Also

get_driver_info(), get_team_info(), load_series(), series_data

Examples

# Career summary across all series
get_manufacturer_info("Toyota")

# Season-by-season Cup data
get_manufacturer_info(
  "Toyota",
  series = "cup",
  type = "season"
)

Description

Search for a team by name and return performance statistics. Supports partial names, typos, and case-insensitive input via the built-in fuzzy matching engine.

Usage

get_team_info(team, series = "all", type = "summary", interactive = TRUE)

Arguments

Value

A tibble of team statistics (format depends on type), or invisible(NULL) if no match is found.

See Also

get_driver_info(), get_manufacturer_info(), load_series(), series_data

Examples

# Career summary across all series
get_team_info("Joe Gibbs Racing")

# Season-by-season Cup data
get_team_info(
  "Joe Gibbs Racing",
  series = "cup",
  type = "season"
)

Description

Downloads NASCAR series data from Cloudflare R2 as a parquet file. Data is cached in memory for the current R session so repeated calls are instant. Each new R session downloads fresh data, ensuring you always have the latest results.

Usage

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

Arguments

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 memory for the current R session. Repeated calls return instantly without re-downloading. Starting a new R session always fetches the latest data from R2.

Use refresh = TRUE to force a re-download within a session, or clear_cache() to reset the in-memory cache.

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.

See Also

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

Examples

# 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)

Description

Historical race results from NASCAR's three major national series, sourced with permission from DriverAverages.com. Data is hosted on Cloudflare R2 and accessed via load_series().

Cup Series (1949–present)

The NASCAR Cup Series is the sport's premier division. Originally called the Strictly Stock Series in its inaugural 1949 season, it has been known by several names tied to title sponsors: Grand National (1950–1970), Winston Cup (1971–2003), Nextel Cup (2004–2007), Sprint Cup (2008–2016), Monster Energy Cup (2017–2019), and the NASCAR Cup Series (2020–present).

cup <- load_series("cup")

Xfinity / O'Reilly Auto Parts Series (1982–present)

NASCAR's second-tier national series, often considered a proving ground for drivers aspiring to reach the Cup Series. It debuted in 1982 as the Budweiser Late Model Sportsman Series and has carried the names of several title sponsors: Busch Series (1984–2007), Nationwide Series (2008–2014), Xfinity Series (2015–2025), and the O'Reilly Auto Parts Series (2026–present).

nxs <- load_series("nxs")

The series identifier is "nxs", NASCAR's own sponsor-neutral abbreviation. This avoids tying the code to any single title sponsor.

Truck Series (1995–present)

The NASCAR Craftsman Truck Series features modified pickup trucks racing on a mix of ovals, short tracks, road courses, and dirt tracks. It launched in 1995 as the SuperTruck Series and has been sponsored under the names Craftsman Truck (1995–2008), Camping World Truck (2009–2022), and Craftsman Truck again (2023–present).

truck <- load_series("truck")

Variables

All three series share the same column structure:

Season

Integer. Year the race took place.

Race

Integer. Race number within the season.

Track

Character. Name of the track or venue.

Name

Character. Official race name (includes sponsor).

Length

Numeric. Track length in miles.

Surface

Character. Track surface type (e.g., "Paved", "Dirt").

Finish

Integer. Official finishing position.

Start

Integer. Starting grid position.

Car

Character. Car number.

Driver

Character. Driver's full name.

Team

Character. Team or car owner name.

Make

Character. Vehicle manufacturer (e.g., "Chevrolet", "Ford", "Toyota").

Pts

Integer. Championship points earned.

Laps

Integer. Total laps completed.

Led

Integer. Number of laps led.

Status

Character. Race completion status (e.g., "Running", "Crash", "Engine").

S1

Numeric. Stage 1 points (2017–present, NA for earlier seasons).

S2

Numeric. Stage 2 points (2017–present, NA for earlier seasons).

S3

Numeric. Stage 3 points. Cup Series only, 2024–present (NA for NXS, Truck, and pre-2024 Cup).

Rating

Numeric. Driver/loop rating for the race (NA where unavailable).

Win

Integer. Win indicator (1 = won, 0 = did not win).

Data Source

All data is sourced with permission from DriverAverages.com and updated weekly via an automated pipeline. See load_series() for access details and clear_cache() for cache management.