Get player usage metrics
Usage
cfbd_player_usage(
year = 2019,
team = NULL,
conference = NULL,
position = NULL,
athlete_id = NULL,
excl_garbage_time = FALSE
)Arguments
- year
(Integer required, default 2019): Year, 4 digit format (YYYY).
- team
(String optional): Team - Select a valid team, D1 football
- conference
(String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC
- position
(string optional): Position of the player you are searching for. Position Group - options include:
Offense: QB, RB, FB, TE, OL, G, OT, C, WR
Defense: DB, CB, S, LB, DE, DT, NT, DL
Special Teams: K, P, LS, PK
- athlete_id
(Integer optional): Athlete ID filter for querying a single athlete Can be found using the
cfbd_player_info()function.- excl_garbage_time
(Logical default FALSE): Select whether to exclude Garbage Time (TRUE/FALSE)
Value
cfbd_player_usage() - A data frame with 14 variables:
season: integer.Player usage season.
athlete_id: character.Referencing athlete id.
name: character.Athlete name.
position: character.Athlete position.
team: character.Team name.
conference: character.Conference of team.
usg_overall: double.Player usage of overall offense.
usg_pass: double.Player passing usage percentage.
usg_rush: double.Player rushing usage percentage.
usg_1st_down: double.Player first down usage percentage.
usg_2nd_down: double.Player second down usage percentage.
usg_3rd_down: double.Player third down usage percentage.
usg_standard_downs: double.Player standard down usage percentage.
usg_passing_downs: double.Player passing down usage percentage.
Examples
# \donttest{
try(cfbd_player_usage(year = 2019, position = "WR", team = "Florida State"))
#> ── Player usage data from CollegeFootballData.com ──────────── cfbfastR 1.9.5 ──
#> ℹ Data updated: 2024-09-10 01:23:52 UTC
#> # A tibble: 9 × 14
#> season athlete_id name position team conference usg_overall usg_pass
#> <int> <chr> <chr> <chr> <chr> <chr> <dbl> <dbl>
#> 1 2019 4240028 Tamorrion Te… WR Flor… ACC 0.117 0.217
#> 2 2019 4240034 D.J. Matthews WR Flor… ACC 0.0638 0.114
#> 3 2019 4363046 Tre'Shaun Ha… WR Flor… ACC 0.0433 0.0766
#> 4 2019 4240033 Ontaria Wils… WR Flor… ACC 0.0353 0.0635
#> 5 2019 4363032 Keyshawn Hel… WR Flor… ACC 0.0262 0.046
#> 6 2019 4035628 Keith Gavin WR Flor… ACC 0.0239 0.046
#> 7 2019 4363030 Warren Thomp… WR Flor… ACC 0.008 0.0153
#> 8 2019 4363044 Jordan Young WR Flor… ACC 0.0068 0.0109
#> 9 2019 4360473 Adarius Dent WR Flor… ACC 0.0046 0.0088
#> # ℹ 6 more variables: usg_rush <dbl>, usg_1st_down <dbl>, usg_2nd_down <dbl>,
#> # usg_3rd_down <dbl>, usg_standard_downs <dbl>, usg_passing_downs <dbl>
# }