| statcast_leaderboards {baseballr} | R Documentation |
Query Baseball Savant Leaderboards
Description
This function allows you to read leaderboard data from BaseballSavant directly into R as data frame.
Usage
statcast_leaderboards(
leaderboard = "exit_velocity_barrels",
year = 2020,
abs = 50,
min_pa = "q",
min_pitches = 100,
min_throws = 100,
min_field = "q",
min_run = 0,
player_type = "batter",
fielding_type = "player",
oaa_position = "",
oaa_roles = "",
team = "",
arsenal_type = "n_",
run_type = "raw",
min2b = 5,
min3b = 0,
position = "",
bats = "",
hand = ""
)
Arguments
leaderboard |
The type of leaderboard to retrieve, input as a string. Current options include exit_velocity_barrels, expected_statistics, pitch_arsenal, outs_above_average, directional_oaa, catch_probability, pop_time, sprint_speed, and running_splits_90_ft, arm_strength. |
year |
The season for which you want data. |
abs |
The minimum number of batted balls. Applies only to exit_velocity_barrels leaderboards. |
min_pa |
Minimum number of plate appearances. Can be a number or 'q' for qualified batters. |
min_pitches |
Minimum number of pitches thrown. |
min_throws |
Minimum number of throwing opportunities. |
min_field |
Minimum number of fieding opportunities. |
min_run |
Minimum number of running opportunities. |
player_type |
One of either 'batter' or pitcher. For the expected_statistics leaderboard, 'batter-team' and 'pitcher-team' are also available. |
fielding_type |
One of either 'player' or 'team'. |
oaa_position |
Can be either the number position of a player or 'if' or 'of' for position categories. |
oaa_roles |
Can be either the number position of a player or 'if' or 'of' for position categories. |
team |
An abbreviation for a team. Can be left blank. |
arsenal_type |
One of either 'n_', 'avg_spin', or 'avg_speed'. |
run_type |
One of either 'percent' or 'raw'. |
min2b |
The minimum number of throwing attempts to second base. |
min3b |
The minimum number of throwing attempts to third base. |
position |
The numeric position of the player. For DH use 10. Can be left blank. |
bats |
The handedness of the batter. One of 'R' or 'L'. Can be left blank. |
hand |
The handedness of the pitcher. One of 'R' or 'L'. Can be left blank. |
Details
oaa_roles argument: 30 = 1B - Straight Up 31 = 1B - Towards 1B/2B Hole 32 = 1B - Close to Line 40 = 2B - Straight Up 41 = 2B - Shaded Towards 2B Bag 42 = 2B - Towards 1B/2B Hole 43 = 2B - Behind First Basemen 46 = 2B - Up the Middle 60 = SS - Straight Up 61 = SS - Towards 3B/SS Hole 62 = SS - Shaded Towards 2B Bag 64 = SS - Up the Middle 50 = 3B - Straight Up 51 = 3B - Close to Line 52 = 3B - Towards 3B/SS Hole 77 = LF - Close to Line 71 = LF - Leaning Left 70 = LF - Straight Up 72 = LF - Leaning Right 78 = LF - LF Gap 87 = CF - LF Gap 81 = CF - Leaning Left 82 = CF - Leaning Right 89 = CF - RF Gap 98 = RF - RF Gap 91 = RF - Leaning Left 90 = RF - Straight Up 92 = RF - Leaning Right 99 = RF - Close to Line
Value
Returns a tibble of Statcast leaderboard data with the following columns (for leaderboard: 'exit_velocity_barrels'):
| col_name | types |
| year | numeric |
| last_name | character |
| first_name | character |
| player_id | integer |
| attempts | integer |
| avg_hit_angle | numeric |
| anglesweetspotpercent | numeric |
| max_hit_speed | numeric |
| avg_hit_speed | numeric |
| fbld | numeric |
| gb | numeric |
| max_distance | integer |
| avg_distance | integer |
| avg_hr_distance | integer |
| ev95plus | integer |
| ev95per-swing | numeric |
| ev95percent | numeric |
| barrels | integer |
| brl_percent | numeric |
| brl_pa | numeric |
Examples
try(statcast_leaderboards(leaderboard = "expected_statistics", year = 2018))
try(statcast_leaderboards(leaderboard = "arm_strength", year = 2020))