Skip to contents

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.3 ──
#>  Data updated: 2022-09-23 03:23:30 UTC
#> # A tibble: 9 × 14
#>   season athlete_id name   posit…¹ team  confe…² usg_o…³ usg_p…⁴ usg_r…⁵ usg_1…⁶
#>    <int> <chr>      <chr>  <chr>   <chr> <chr>     <dbl>   <dbl>   <dbl>   <dbl>
#> 1   2019 4240028    Tamor… WR      Flor… ACC      0.129   0.236   0.012   0.151 
#> 2   2019 4240034    D.J. … WR      Flor… ACC      0.0672  0.120   0.0096  0.0513
#> 3   2019 4363046    Tre'S… WR      Flor… ACC      0.0456  0.081   0.0072  0.041 
#> 4   2019 4240033    Ontar… WR      Flor… ACC      0.0376  0.0656  0.0072  0.041 
#> 5   2019 4363032    Keysh… WR      Flor… ACC      0.0296  0.0525  0.0048  0.0359
#> 6   2019 4035628    Keith… WR      Flor… ACC      0.0239  0.046   0       0.0205
#> 7   2019 4363030    Warre… WR      Flor… ACC      0.008   0.0153  0       0.0077
#> 8   2019 4363044    Jorda… WR      Flor… ACC      0.0068  0.0109  0.0024  0.0051
#> 9   2019 4360473    Adari… WR      Flor… ACC      0.0046  0.0088  0       0.0077
#> # … with 4 more variables: usg_2nd_down <dbl>, usg_3rd_down <dbl>,
#> #   usg_standard_downs <dbl>, usg_passing_downs <dbl>, and abbreviated variable
#> #   names ¹​position, ²​conference, ³​usg_overall, ⁴​usg_pass, ⁵​usg_rush,
#> #   ⁶​usg_1st_down
# }