Skip to contents

Load Strokes Gained Statistics

Source: R/load_strokes_gained.R
load_strokes_gained.Rd

Returns strokes gained data from the PGA Tour, with all six SG categories per player: putting, around the green, approach, off the tee, tee to green, and total.

Usage

load_strokes_gained(player = NULL, use_bundled = FALSE)

Arguments

player

Optional player name filter (partial match, case-insensitive).

use_bundled

If TRUE, skip the download and use the dataset bundled with the package. Defaults to FALSE.

Value

A tibble with one row per player and columns:

  • player_id: PGA Tour player ID

  • player_name: Player display name

  • country: Three-letter country code

  • sg_putt: Strokes Gained: Putting (per round avg)

  • sg_arg: Strokes Gained: Around the Green (per round avg)

  • sg_app: Strokes Gained: Approach the Green (per round avg)

  • sg_ott: Strokes Gained: Off the Tee (per round avg)

  • sg_t2g: Strokes Gained: Tee to Green (per round avg)

  • sg_total: Strokes Gained: Total (per round avg)

  • rounds: Number of measured (ShotLink) rounds

  • season: PGA Tour season year

Details

By default, downloads the latest data from GitHub releases (updated weekly). Falls back to the bundled dataset shipped with the package if the download fails (e.g., no internet connection).

Examples

# Get all strokes gained data (downloads latest)
sg <- load_strokes_gained()

# Use bundled data (no internet needed)
sg <- load_strokes_gained(use_bundled = TRUE)

# Look up a specific player
load_strokes_gained("Scheffler")
#> # A tibble: 7 × 11
#>   player_id player_name     country sg_putt sg_arg sg_app sg_ott sg_t2g sg_total
#>   <chr>     <chr>           <chr>     <dbl>  <dbl>  <dbl>  <dbl>  <dbl>    <dbl>
#> 1 46046     Scottie Scheff… USA      -0.053  0.115  0.398  0.618  1.13     1.08 
#> 2 46046     Scottie Scheff… USA       0.023  0.249  0.145  0.515  0.909    0.932
#> 3 46046     Scottie Scheff… USA       0.202  0.3    0.819  0.356  1.48     1.68 
#> 4 46046     Scottie Scheff… USA      -0.301  0.399  1.19   1.02   2.62     2.31 
#> 5 46046     Scottie Scheff… USA       0.095  0.316  1.27   0.816  2.40     2.50 
#> 6 46046     Scottie Scheff… USA       0.382  0.322  1.29   0.748  2.36     2.74 
#> 7 46046     Scottie Scheff… USA       0.512  0.471  0.601  0.665  1.74     2.25 
#> # ℹ 2 more variables: rounds <int>, season <int>