Get player usage metrics

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{
cfbd_player_usage(year = 2019, position = "WR", team = "Florida State")
#>   season athlete_id               name position          team conference
#> 1   2019    4240028    Tamorrion Terry       WR Florida State        ACC
#> 2   2019    4240034      D.J. Matthews       WR Florida State        ACC
#> 3   2019    4363046 Tre'Shaun Harrison       WR Florida State        ACC
#> 4   2019    4240033     Ontaria Wilson       WR Florida State        ACC
#> 5   2019    4363032    Keyshawn Helton       WR Florida State        ACC
#> 6   2019    4035628        Keith Gavin       WR Florida State        ACC
#> 7   2019    4363030    Warren Thompson       WR Florida State        ACC
#> 8   2019    4363044       Jordan Young       WR Florida State        ACC
#> 9   2019    4360473       Adarius Dent       WR Florida State        ACC
#>   usg_overall usg_pass usg_rush usg_1st_down usg_2nd_down usg_3rd_down
#> 1      0.1287   0.2363   0.0120       0.1513        0.110        0.120
#> 2      0.0672   0.1204   0.0096       0.0513        0.082        0.087
#> 3      0.0456   0.0810   0.0072       0.0410        0.046        0.060
#> 4      0.0376   0.0656   0.0072       0.0410        0.032        0.044
#> 5      0.0296   0.0525   0.0048       0.0359        0.025        0.027
#> 6      0.0239   0.0460   0.0000       0.0205        0.028        0.027
#> 7      0.0080   0.0153   0.0000       0.0077        0.014        0.000
#> 8      0.0068   0.0109   0.0024       0.0051        0.007        0.011
#> 9      0.0046   0.0088   0.0000       0.0077        0.004        0.000
#>   usg_standard_downs usg_passing_downs
#> 1              0.063             0.138
#> 2              0.043             0.101
#> 3              0.053             0.044
#> 4              0.043             0.034
#> 5              0.010             0.034
#> 6              0.014             0.034
#> 7              0.005             0.010
#> 8              0.010             0.007
#> 9              0.014             0.000
# }