Get player usage metrics

Get player usage metrics

Usage

cfbd_player_usage(
  year = most_recent_cfb_season(),
  team = NULL,
  conference = NULL,
  position = NULL,
  athlete_id = NULL,
  excl_garbage_time = FALSE
)

Arguments

year

(Integer required, default most recent season): 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:

col_name	types	description
season	integer	Four-digit season year for player usage.
athlete_id	character	Unique CFBD athlete identifier.
name	character	Athlete full name.
position	character	Athlete position abbreviation (e.g. QB, RB, WR).
team	character	Team name.
conference	character	Conference of team.
usg_overall	numeric	Player share of overall offensive usage.
usg_pass	numeric	Player share of team passing usage.
usg_rush	numeric	Player share of team rushing usage.
usg_1st_down	numeric	Player share of team usage on first downs.
usg_2nd_down	numeric	Player share of team usage on second downs.
usg_3rd_down	numeric	Player share of team usage on third downs.
usg_standard_downs	numeric	Player share of team usage on standard downs.
usg_passing_downs	numeric	Player share of team usage on passing downs.

Examples

# \donttest{
  try(cfbd_player_usage(year = 2019, position = "WR", team = "Florida State"))
#> ── Player usage data from CollegeFootballData.com ──────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-24 02:04:48 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 4035628    Keith Gavin   WR       Flor… ACC              0.033    0.063
#> 2   2019 4240028    Tamorrion Te… WR       Flor… ACC              0.115    0.211
#> 3   2019 4240033    Ontaria Wils… WR       Flor… ACC              0.056    0.098
#> 4   2019 4240034    D.J. Matthews WR       Flor… ACC              0.071    0.129
#> 5   2019 4360473    Adarius Dent  WR       Flor… ACC              0.029    0.063
#> 6   2019 4363030    Warren Thomp… WR       Flor… ACC              0.023    0.043
#> 7   2019 4363032    Keyshawn Hel… WR       Flor… ACC              0.069    0.106
#> 8   2019 4363044    Jordan Young  WR       Flor… ACC              0.028    0.053
#> 9   2019 4363046    Tre'Shaun Ha… WR       Flor… ACC              0.059    0.099
#> # ℹ 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>
# }

Usage

Arguments

Value

See also

Examples