Column-level documentation for the main golfastr datasets. The same
tables are available in R via pga_field_descriptions().
Leaderboard
Returned by load_leaderboard() and
leaderboard().
| field | description |
|---|---|
| position | Final tournament standing |
| player_id | ESPN athlete ID |
| player_name | Player display name |
| total_score | Total strokes across completed rounds |
| score_to_par | Score relative to par (e.g., ‘-11’, ‘E’, ‘+5’) |
| status | Player status (live API only) |
| tournament_id | ESPN event ID |
| tournament_name | Name of the tournament |
| year | Tournament year |
Hole-by-hole
Returned by load_holes().
| field | description |
|---|---|
| player_id | ESPN athlete ID |
| player_name | Player display name |
| position | Final leaderboard standing |
| tournament_id | ESPN event ID |
| tournament_name | Name of the tournament |
| round | Round number (5 = playoff) |
| hole | Hole number (1-18) |
| par | Par for the hole |
| score | Strokes taken on the hole |
| score_type | Score classification (EAGLE, BIRDIE, PAR, BOGEY, etc.) |
| year | Tournament year |
| field_avg | Field scoring average on the hole in that round (hosted data only) |
| to_par | Score relative to par on the hole (hosted data only) |
| vs_field | Strokes vs the field average on the hole (hosted data only) |
| cume_to_par | Running tournament score to par through the hole, playoff holes included (hosted data only) |
Strokes gained
Returned by load_strokes_gained() and available as the
packaged strokes_gained dataset. Values are per-round
averages from ShotLink-measured rounds.
| Field | Description |
|---|---|
| player_id | PGA Tour player ID |
| player_name | Player display name |
| country | Three-letter country code (e.g., “USA”, “ENG”) |
| sg_putt | Strokes Gained: Putting |
| sg_arg | Strokes Gained: Around the Green |
| sg_app | Strokes Gained: Approach the Green |
| sg_ott | Strokes Gained: Off the Tee |
| sg_t2g | Strokes Gained: Tee to Green |
| sg_total | Strokes Gained: Total |
| rounds | Number of ShotLink-measured rounds |
| season | PGA Tour season year |