fg_batter_game_logs: *Scrape Batter Game Logs from FanGraphs*
In baseballr: Acquiring and Analyzing Baseball Data
View source: R/fg_batter_game_logs.R
fg_batter_game_logs R Documentation
Scrape Batter Game Logs from FanGraphs
Description
This function allows you to scrape game logs by year for a batter from FanGraphs.com.
Usage
fg_batter_game_logs(playerid, year)
Arguments
playerid
This is the playerid used by FanGraphs for a given player
year
The season for which game logs should be returned (use the YYYY format)
Value
A data frame of batter game logs, one row per game, with the following columns:
col_name types description
PlayerName character Player name.
playerid integer FanGraphs player ID.
Date character Calendar date of the game (YYYY-MM-DD).
Team character Team the player appeared for.
Opp character Opponent team; leading @ indicates a road game.
season integer Season year.
Age integer Player age during the season.
BatOrder character Spot in the batting order.
Pos character Fielding position played.
G numeric Games (1 per row).
AB numeric At-bats.
PA numeric Plate appearances.
H numeric Hits.
1B numeric Singles.
2B numeric Doubles.
3B numeric Triples.
HR numeric Home runs.
R numeric Runs scored.
RBI numeric Runs batted in.
BB numeric Walks (bases on balls).
IBB numeric Intentional walks.
SO numeric Strikeouts.
HBP numeric Times hit by pitch.
SF numeric Sacrifice flies.
SH numeric Sacrifice hits (bunts).
GDP numeric Grounded into double plays.
SB numeric Stolen bases.
CS numeric Times caught stealing.
AVG numeric Batting average.
GB numeric Ground balls.
FB numeric Fly balls.
LD numeric Line drives.
IFFB numeric Infield fly balls.
Pitches numeric Pitches seen.
Balls numeric Balls.
Strikes numeric Strikes.
IFH numeric Infield hits.
BU numeric Bunts.
BUH numeric Bunt hits.
BB% numeric Walk rate.
K% numeric Strikeout rate.
BB/K numeric Walk-to-strikeout ratio.
OBP numeric On-base percentage.
SLG numeric Slugging percentage.
OPS numeric On-base plus slugging.
ISO numeric Isolated power.
BABIP numeric Batting average on balls in play.
GB/FB numeric Ground-ball to fly-ball ratio.
LD% numeric Line-drive rate.
GB% numeric Ground-ball rate.
FB% numeric Fly-ball rate.
IFFB% numeric Infield-fly-ball rate.
HR/FB numeric Home-run-per-fly-ball rate.
IFH% numeric Infield-hit rate.
BUH% numeric Bunt-hit rate.
wOBA numeric Weighted on-base average.
wRAA numeric Weighted runs above average.
wRC numeric Weighted runs created.
Spd numeric Bill James Speed Score.
wRC+ numeric Weighted runs created plus (100 = average).
wBSR numeric Weighted base running runs.
WPA numeric Win probability added.
-WPA numeric Negative win probability added.
+WPA numeric Positive win probability added.
RE24 numeric Run expectancy based on 24 base-out states.
REW numeric Run expectancy wins.
pLI numeric Average leverage index.
PH numeric Pinch-hit appearances.
WPA/LI numeric Context-neutral win probability added.
Clutch numeric Clutch performance score.
FB%1 numeric Fastball usage rate.
FBv numeric Average four-seam fastball velocity (mph).
SL% numeric slider usage rate.
SLv numeric Average slider velocity (mph).
CT% numeric cutter usage rate.
CTv numeric Average cutter velocity (mph).
CB% numeric curveball usage rate.
CBv numeric Average curveball velocity (mph).
CH% numeric changeup usage rate.
CHv numeric Average changeup velocity (mph).
SF% numeric split-finger fastball usage rate.
SFv numeric Average split-finger fastball velocity (mph).
XX% numeric unknown/other pitch usage rate.
wFB numeric Total runs above average on the fastball.
wSL numeric Total runs above average on the slider.
wCT numeric Total runs above average on the cutter.
wCB numeric Total runs above average on the curveball.
wCH numeric Total runs above average on the changeup.
wSF numeric Total runs above average on the split-finger fastball.
wFB/C numeric Runs above average per 100 fastballs.
wSL/C numeric Runs above average per 100 sliders.
wCT/C numeric Runs above average per 100 cutters.
wCB/C numeric Runs above average per 100 curveballs.
wCH/C numeric Runs above average per 100 changeups.
wSF/C numeric Runs above average per 100 split-finger fastballs.
O-Swing% numeric Swing rate on pitches outside the zone.
Z-Swing% numeric Swing rate on pitches in the zone.
Swing% numeric Overall swing rate.
O-Contact% numeric Contact rate on pitches outside the zone.
Z-Contact% numeric Contact rate on pitches in the zone.
Contact% numeric Overall contact rate.
Zone% numeric Rate of pitches in the strike zone.
F-Strike% numeric First-pitch strike rate.
SwStr% numeric Swinging-strike rate.
Pull numeric Pulled batted balls.
Cent numeric Batted balls hit up the middle.
Oppo numeric Opposite-field batted balls.
Soft numeric Soft-hit batted balls.
Med numeric Medium-hit batted balls.
Hard numeric Hard-hit batted balls.
bipCount numeric Balls in play.
Pull% numeric Pulled batted-ball rate.
Cent% numeric Up-the-middle batted-ball rate.
Oppo% numeric Opposite-field batted-ball rate.
Soft% numeric Soft-contact rate.
Med% numeric Medium-contact rate.
Hard% numeric Hard-contact rate.
xwOBA numeric Expected weighted on-base average.
xAVG numeric Expected batting average.
xSLG numeric Expected slugging percentage.
pfxFA% numeric PITCHf/x four-seam fastball usage rate.
pfxFC% numeric PITCHf/x cutter usage rate.
pfxFS% numeric PITCHf/x splitter usage rate.
pfxFO% numeric PITCHf/x forkball usage rate.
pfxSI% numeric PITCHf/x sinker usage rate.
pfxSL% numeric PITCHf/x slider usage rate.
pfxCU% numeric PITCHf/x curveball usage rate.
pfxKC% numeric PITCHf/x knuckle curve usage rate.
pfxCH% numeric PITCHf/x changeup usage rate.
pfxSLO% numeric PITCHf/x slurve usage rate.
pfxST% numeric PITCHf/x sweeper usage rate.
pfxCUO% numeric PITCHf/x other curve usage rate.
pfxCV% numeric PITCHf/x curve usage rate.
pfxvFA numeric PITCHf/x average four-seam fastball velocity (mph).
pfxvFC numeric PITCHf/x average cutter velocity (mph).
pfxvFS numeric PITCHf/x average splitter velocity (mph).
pfxvFO numeric PITCHf/x average forkball velocity (mph).
pfxvSI numeric PITCHf/x average sinker velocity (mph).
pfxvSL numeric PITCHf/x average slider velocity (mph).
pfxvCU numeric PITCHf/x average curveball velocity (mph).
pfxvKC numeric PITCHf/x average knuckle curve velocity (mph).
pfxvCH numeric PITCHf/x average changeup velocity (mph).
pfxvSLO numeric PITCHf/x average slurve velocity (mph).
pfxvST numeric PITCHf/x average sweeper velocity (mph).
pfxvCUO numeric PITCHf/x average other curve velocity (mph).
pfxvCV numeric PITCHf/x average curve velocity (mph).
pfxFA-X numeric PITCHf/x horizontal movement of the four-seam fastball (inches).
pfxFC-X numeric PITCHf/x horizontal movement of the cutter (inches).
pfxFS-X numeric PITCHf/x horizontal movement of the splitter (inches).
pfxFO-X numeric PITCHf/x horizontal movement of the forkball (inches).
pfxSI-X numeric PITCHf/x horizontal movement of the sinker (inches).
pfxSL-X numeric PITCHf/x horizontal movement of the slider (inches).
pfxCU-X numeric PITCHf/x horizontal movement of the curveball (inches).
pfxKC-X numeric PITCHf/x horizontal movement of the knuckle curve (inches).
pfxCH-X numeric PITCHf/x horizontal movement of the changeup (inches).
pfxSLO-X numeric PITCHf/x horizontal movement of the slurve (inches).
pfxST-X numeric PITCHf/x horizontal movement of the sweeper (inches).
pfxCUO-X numeric PITCHf/x horizontal movement of the other curve (inches).
pfxCV-X numeric PITCHf/x horizontal movement of the curve (inches).
pfxFA-Z numeric PITCHf/x vertical movement of the four-seam fastball (inches).
pfxFC-Z numeric PITCHf/x vertical movement of the cutter (inches).
pfxFS-Z numeric PITCHf/x vertical movement of the splitter (inches).
pfxFO-Z numeric PITCHf/x vertical movement of the forkball (inches).
pfxSI-Z numeric PITCHf/x vertical movement of the sinker (inches).
pfxSL-Z numeric PITCHf/x vertical movement of the slider (inches).
pfxCU-Z numeric PITCHf/x vertical movement of the curveball (inches).
pfxKC-Z numeric PITCHf/x vertical movement of the knuckle curve (inches).
pfxCH-Z numeric PITCHf/x vertical movement of the changeup (inches).
pfxSLO-Z numeric PITCHf/x vertical movement of the slurve (inches).
pfxST-Z numeric PITCHf/x vertical movement of the sweeper (inches).
pfxCUO-Z numeric PITCHf/x vertical movement of the other curve (inches).
pfxCV-Z numeric PITCHf/x vertical movement of the curve (inches).
pfxwFA numeric PITCHf/x total runs above average on the four-seam fastball.
pfxwFC numeric PITCHf/x total runs above average on the cutter.
pfxwFS numeric PITCHf/x total runs above average on the splitter.
pfxwFO numeric PITCHf/x total runs above average on the forkball.
pfxwSI numeric PITCHf/x total runs above average on the sinker.
pfxwSL numeric PITCHf/x total runs above average on the slider.
pfxwCU numeric PITCHf/x total runs above average on the curveball.
pfxwKC numeric PITCHf/x total runs above average on the knuckle curve.
pfxwCH numeric PITCHf/x total runs above average on the changeup.
pfxwSLO numeric PITCHf/x total runs above average on the slurve.
pfxwST numeric PITCHf/x total runs above average on the sweeper.
pfxwCUO numeric PITCHf/x total runs above average on the other curve.
pfxwCV numeric PITCHf/x total runs above average on the curve.
pfxwFA/C numeric PITCHf/x runs above average per 100 four-seam fastballs.
pfxwFC/C numeric PITCHf/x runs above average per 100 cutters.
pfxwFS/C numeric PITCHf/x runs above average per 100 splitters.
pfxwFO/C numeric PITCHf/x runs above average per 100 forkballs.
pfxwSI/C numeric PITCHf/x runs above average per 100 sinkers.
pfxwSL/C numeric PITCHf/x runs above average per 100 sliders.
pfxwCU/C numeric PITCHf/x runs above average per 100 curveballs.
pfxwKC/C numeric PITCHf/x runs above average per 100 knuckle curves.
pfxwCH/C numeric PITCHf/x runs above average per 100 changeups.
pfxwSLO/C numeric PITCHf/x runs above average per 100 slurves.
pfxwST/C numeric PITCHf/x runs above average per 100 sweepers.
pfxwCUO/C numeric PITCHf/x runs above average per 100 other curves.
pfxwCV/C numeric PITCHf/x runs above average per 100 curves.
pfxaaFA numeric PITCHf/x average spin/active component on the four-seam fastball.
pfxaaFC numeric PITCHf/x average spin/active component on the cutter.
pfxaaFS numeric PITCHf/x average spin/active component on the splitter.
pfxaaFO numeric PITCHf/x average spin/active component on the forkball.
pfxaaSI numeric PITCHf/x average spin/active component on the sinker.
pfxaaSL numeric PITCHf/x average spin/active component on the slider.
pfxaaCU numeric PITCHf/x average spin/active component on the curveball.
pfxaaKC numeric PITCHf/x average spin/active component on the knuckle curve.
pfxaaCH numeric PITCHf/x average spin/active component on the changeup.
pfxaaSLO numeric PITCHf/x average spin/active component on the slurve.
pfxaaST numeric PITCHf/x average spin/active component on the sweeper.
pfxaaCUO numeric PITCHf/x average spin/active component on the other curve.
pfxaaCV numeric PITCHf/x average spin/active component on the curve.
pfxspFA numeric PITCHf/x average spin rate on the four-seam fastball (rpm).
pfxspFC numeric PITCHf/x average spin rate on the cutter (rpm).
pfxspFS numeric PITCHf/x average spin rate on the splitter (rpm).
pfxspFO numeric PITCHf/x average spin rate on the forkball (rpm).
pfxspSI numeric PITCHf/x average spin rate on the sinker (rpm).
pfxspSL numeric PITCHf/x average spin rate on the slider (rpm).
pfxspCU numeric PITCHf/x average spin rate on the curveball (rpm).
pfxspKC numeric PITCHf/x average spin rate on the knuckle curve (rpm).
pfxspCH numeric PITCHf/x average spin rate on the changeup (rpm).
pfxspSLO numeric PITCHf/x average spin rate on the slurve (rpm).
pfxspST numeric PITCHf/x average spin rate on the sweeper (rpm).
pfxspCUO numeric PITCHf/x average spin rate on the other curve (rpm).
pfxspCV numeric PITCHf/x average spin rate on the curve (rpm).
pfxO-Swing% numeric PITCHf/x Swing rate on pitches outside the zone.
pfxZ-Swing% numeric PITCHf/x Swing rate on pitches in the zone.
pfxSwing% numeric PITCHf/x Overall swing rate.
pfxO-Contact% numeric PITCHf/x Contact rate on pitches outside the zone.
pfxZ-Contact% numeric PITCHf/x Contact rate on pitches in the zone.
pfxContact% numeric PITCHf/x Overall contact rate.
pfxZone% numeric PITCHf/x Rate of pitches in the strike zone.
pfxPace numeric PITCHf/x Average seconds between pitches.
AvgBatSpeed numeric Average bat speed (mph).
FastSwing% numeric Rate of fast swings.
SwingLength numeric Average swing length (feet).
SquaredUpContact% numeric Squared-up rate per contact.
SquaredUpSwing% numeric Squared-up rate per swing.
BlastContact% numeric Blast rate per contact.
BlastSwing% numeric Blast rate per swing.
Swords numeric Swords (especially ugly swinging strikeouts).
CompetitiveSwings numeric Competitive swings.
Tilt numeric Average swing tilt (degrees).
AttackAngle numeric Average attack angle (degrees).
AttackDirection numeric Average attack direction (degrees).
IdealAttackAngle% numeric Rate of swings in the ideal attack-angle range.
DepthInBox numeric Average depth in the batter's box (inches).
DistanceOffPlate numeric Average distance off the plate (inches).
scH-Swing% numeric Statcast heart-zone swing rate.
scH-Contact% numeric Statcast heart-zone contact rate.
scH-Zone% numeric Statcast heart-zone zone rate.
scS-Swing% numeric Statcast shadow-zone swing rate.
scS-Contact% numeric Statcast shadow-zone contact rate.
scS-Zone% numeric Statcast shadow-zone zone rate.
scC-Swing% numeric Statcast chase-zone swing rate.
scC-Contact% numeric Statcast chase-zone contact rate.
scC-Zone% numeric Statcast chase-zone zone rate.
scW-Swing% numeric Statcast waste-zone swing rate.
scW-Contact% numeric Statcast waste-zone contact rate.
scW-Zone% numeric Statcast waste-zone zone rate.
scSI-Swing% numeric Statcast in-zone strike-zone swing rate.
scSI-Contact% numeric Statcast in-zone strike-zone contact rate.
scSI-Zone% numeric Statcast in-zone strike-zone zone rate.
scSO-Swing% numeric Statcast out-of-zone strike-zone swing rate.
scSO-Contact% numeric Statcast out-of-zone strike-zone contact rate.
scSO-Zone% numeric Statcast out-of-zone strike-zone zone rate.
scO-Swing% numeric Statcast out-of-zone-zone swing rate.
scO-Contact% numeric Statcast out-of-zone-zone contact rate.
scO-Zone% numeric Statcast out-of-zone-zone zone rate.
scZ-Swing% numeric Statcast in-zone-zone swing rate.
scZ-Contact% numeric Statcast in-zone-zone contact rate.
scZ-Zone% numeric Statcast in-zone-zone zone rate.
piCH% numeric PITCHInfo changeup usage rate.
piCS% numeric PITCHInfo slow curve usage rate.
piCU% numeric PITCHInfo curveball usage rate.
piFA% numeric PITCHInfo four-seam fastball usage rate.
piFC% numeric PITCHInfo cutter usage rate.
piFS% numeric PITCHInfo splitter usage rate.
piSI% numeric PITCHInfo sinker usage rate.
piSL% numeric PITCHInfo slider usage rate.
piXX% numeric PITCHInfo unknown/other pitch usage rate.
pivCH numeric PITCHInfo average changeup velocity (mph).
pivCS numeric PITCHInfo average slow curve velocity (mph).
pivCU numeric PITCHInfo average curveball velocity (mph).
pivFA numeric PITCHInfo average four-seam fastball velocity (mph).
pivFC numeric PITCHInfo average cutter velocity (mph).
pivFS numeric PITCHInfo average splitter velocity (mph).
pivSI numeric PITCHInfo average sinker velocity (mph).
pivSL numeric PITCHInfo average slider velocity (mph).
pivXX numeric PITCHInfo average unknown/other pitch velocity (mph).
piCH-X numeric PITCHInfo horizontal movement of the changeup (inches).
piCS-X numeric PITCHInfo horizontal movement of the slow curve (inches).
piCU-X numeric PITCHInfo horizontal movement of the curveball (inches).
piFA-X numeric PITCHInfo horizontal movement of the four-seam fastball (inches).
piFC-X numeric PITCHInfo horizontal movement of the cutter (inches).
piFS-X numeric PITCHInfo horizontal movement of the splitter (inches).
piSI-X numeric PITCHInfo horizontal movement of the sinker (inches).
piSL-X numeric PITCHInfo horizontal movement of the slider (inches).
piXX-X numeric PITCHInfo horizontal movement of the unknown/other pitch (inches).
piCH-Z numeric PITCHInfo vertical movement of the changeup (inches).
piCS-Z numeric PITCHInfo vertical movement of the slow curve (inches).
piCU-Z numeric PITCHInfo vertical movement of the curveball (inches).
piFA-Z numeric PITCHInfo vertical movement of the four-seam fastball (inches).
piFC-Z numeric PITCHInfo vertical movement of the cutter (inches).
piFS-Z numeric PITCHInfo vertical movement of the splitter (inches).
piSI-Z numeric PITCHInfo vertical movement of the sinker (inches).
piSL-Z numeric PITCHInfo vertical movement of the slider (inches).
piXX-Z numeric PITCHInfo vertical movement of the unknown/other pitch (inches).
piwCH numeric PITCHInfo total runs above average on the changeup.
piwCS numeric PITCHInfo total runs above average on the slow curve.
piwCU numeric PITCHInfo total runs above average on the curveball.
piwFA numeric PITCHInfo total runs above average on the four-seam fastball.
piwFC numeric PITCHInfo total runs above average on the cutter.
piwFS numeric PITCHInfo total runs above average on the splitter.
piwSI numeric PITCHInfo total runs above average on the sinker.
piwSL numeric PITCHInfo total runs above average on the slider.
piwXX numeric PITCHInfo total runs above average on the unknown/other pitch.
piwCH/C numeric PITCHInfo runs above average per 100 changeups.
piwCS/C numeric PITCHInfo runs above average per 100 slow curves.
piwCU/C numeric PITCHInfo runs above average per 100 curveballs.
piwFA/C numeric PITCHInfo runs above average per 100 four-seam fastballs.
piwFC/C numeric PITCHInfo runs above average per 100 cutters.
piwFS/C numeric PITCHInfo runs above average per 100 splitters.
piwSI/C numeric PITCHInfo runs above average per 100 sinkers.
piwSL/C numeric PITCHInfo runs above average per 100 sliders.
piwXX/C numeric PITCHInfo runs above average per 100 unknown/other pitchs.
piO-Swing% numeric PITCHInfo Swing rate on pitches outside the zone.
piZ-Swing% numeric PITCHInfo Swing rate on pitches in the zone.
piSwing% numeric PITCHInfo Overall swing rate.
piO-Contact% numeric PITCHInfo Contact rate on pitches outside the zone.
piZ-Contact% numeric PITCHInfo Contact rate on pitches in the zone.
piContact% numeric PITCHInfo Overall contact rate.
piZone% numeric PITCHInfo Rate of pitches in the strike zone.
Events numeric Batted-ball events with Statcast data.
EV numeric Average exit velocity (mph).
LA numeric Average launch angle (degrees).
Barrels numeric Barreled batted balls.
Barrel% numeric Barrel rate (per batted-ball event).
maxEV numeric Maximum exit velocity (mph).
HardHit numeric Hard-hit batted balls (95+ mph).
HardHit% numeric Hard-hit rate (95+ mph).
gamedate character Game date as parsed from the source feed.
dh integer Doubleheader game indicator (0 = single game).
Examples
try(fg_batter_game_logs(playerid = 19755, year = 2023))
baseballr documentation built on Aug. 27, 2026, 1:07 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
View source: R/fg_batter_game_logs.R
| fg_batter_game_logs | R Documentation |
Scrape Batter Game Logs from FanGraphs
Description
This function allows you to scrape game logs by year for a batter from FanGraphs.com.
Usage
fg_batter_game_logs(playerid, year)
Arguments
playerid |
This is the playerid used by FanGraphs for a given player |
year |
The season for which game logs should be returned (use the YYYY format) |
Value
A data frame of batter game logs, one row per game, with the following columns:
| col_name | types | description |
| PlayerName | character | Player name. |
| playerid | integer | FanGraphs player ID. |
| Date | character | Calendar date of the game (YYYY-MM-DD). |
| Team | character | Team the player appeared for. |
| Opp | character | Opponent team; leading @ indicates a road game. |
| season | integer | Season year. |
| Age | integer | Player age during the season. |
| BatOrder | character | Spot in the batting order. |
| Pos | character | Fielding position played. |
| G | numeric | Games (1 per row). |
| AB | numeric | At-bats. |
| PA | numeric | Plate appearances. |
| H | numeric | Hits. |
| 1B | numeric | Singles. |
| 2B | numeric | Doubles. |
| 3B | numeric | Triples. |
| HR | numeric | Home runs. |
| R | numeric | Runs scored. |
| RBI | numeric | Runs batted in. |
| BB | numeric | Walks (bases on balls). |
| IBB | numeric | Intentional walks. |
| SO | numeric | Strikeouts. |
| HBP | numeric | Times hit by pitch. |
| SF | numeric | Sacrifice flies. |
| SH | numeric | Sacrifice hits (bunts). |
| GDP | numeric | Grounded into double plays. |
| SB | numeric | Stolen bases. |
| CS | numeric | Times caught stealing. |
| AVG | numeric | Batting average. |
| GB | numeric | Ground balls. |
| FB | numeric | Fly balls. |
| LD | numeric | Line drives. |
| IFFB | numeric | Infield fly balls. |
| Pitches | numeric | Pitches seen. |
| Balls | numeric | Balls. |
| Strikes | numeric | Strikes. |
| IFH | numeric | Infield hits. |
| BU | numeric | Bunts. |
| BUH | numeric | Bunt hits. |
| BB% | numeric | Walk rate. |
| K% | numeric | Strikeout rate. |
| BB/K | numeric | Walk-to-strikeout ratio. |
| OBP | numeric | On-base percentage. |
| SLG | numeric | Slugging percentage. |
| OPS | numeric | On-base plus slugging. |
| ISO | numeric | Isolated power. |
| BABIP | numeric | Batting average on balls in play. |
| GB/FB | numeric | Ground-ball to fly-ball ratio. |
| LD% | numeric | Line-drive rate. |
| GB% | numeric | Ground-ball rate. |
| FB% | numeric | Fly-ball rate. |
| IFFB% | numeric | Infield-fly-ball rate. |
| HR/FB | numeric | Home-run-per-fly-ball rate. |
| IFH% | numeric | Infield-hit rate. |
| BUH% | numeric | Bunt-hit rate. |
| wOBA | numeric | Weighted on-base average. |
| wRAA | numeric | Weighted runs above average. |
| wRC | numeric | Weighted runs created. |
| Spd | numeric | Bill James Speed Score. |
| wRC+ | numeric | Weighted runs created plus (100 = average). |
| wBSR | numeric | Weighted base running runs. |
| WPA | numeric | Win probability added. |
| -WPA | numeric | Negative win probability added. |
| +WPA | numeric | Positive win probability added. |
| RE24 | numeric | Run expectancy based on 24 base-out states. |
| REW | numeric | Run expectancy wins. |
| pLI | numeric | Average leverage index. |
| PH | numeric | Pinch-hit appearances. |
| WPA/LI | numeric | Context-neutral win probability added. |
| Clutch | numeric | Clutch performance score. |
| FB%1 | numeric | Fastball usage rate. |
| FBv | numeric | Average four-seam fastball velocity (mph). |
| SL% | numeric | slider usage rate. |
| SLv | numeric | Average slider velocity (mph). |
| CT% | numeric | cutter usage rate. |
| CTv | numeric | Average cutter velocity (mph). |
| CB% | numeric | curveball usage rate. |
| CBv | numeric | Average curveball velocity (mph). |
| CH% | numeric | changeup usage rate. |
| CHv | numeric | Average changeup velocity (mph). |
| SF% | numeric | split-finger fastball usage rate. |
| SFv | numeric | Average split-finger fastball velocity (mph). |
| XX% | numeric | unknown/other pitch usage rate. |
| wFB | numeric | Total runs above average on the fastball. |
| wSL | numeric | Total runs above average on the slider. |
| wCT | numeric | Total runs above average on the cutter. |
| wCB | numeric | Total runs above average on the curveball. |
| wCH | numeric | Total runs above average on the changeup. |
| wSF | numeric | Total runs above average on the split-finger fastball. |
| wFB/C | numeric | Runs above average per 100 fastballs. |
| wSL/C | numeric | Runs above average per 100 sliders. |
| wCT/C | numeric | Runs above average per 100 cutters. |
| wCB/C | numeric | Runs above average per 100 curveballs. |
| wCH/C | numeric | Runs above average per 100 changeups. |
| wSF/C | numeric | Runs above average per 100 split-finger fastballs. |
| O-Swing% | numeric | Swing rate on pitches outside the zone. |
| Z-Swing% | numeric | Swing rate on pitches in the zone. |
| Swing% | numeric | Overall swing rate. |
| O-Contact% | numeric | Contact rate on pitches outside the zone. |
| Z-Contact% | numeric | Contact rate on pitches in the zone. |
| Contact% | numeric | Overall contact rate. |
| Zone% | numeric | Rate of pitches in the strike zone. |
| F-Strike% | numeric | First-pitch strike rate. |
| SwStr% | numeric | Swinging-strike rate. |
| Pull | numeric | Pulled batted balls. |
| Cent | numeric | Batted balls hit up the middle. |
| Oppo | numeric | Opposite-field batted balls. |
| Soft | numeric | Soft-hit batted balls. |
| Med | numeric | Medium-hit batted balls. |
| Hard | numeric | Hard-hit batted balls. |
| bipCount | numeric | Balls in play. |
| Pull% | numeric | Pulled batted-ball rate. |
| Cent% | numeric | Up-the-middle batted-ball rate. |
| Oppo% | numeric | Opposite-field batted-ball rate. |
| Soft% | numeric | Soft-contact rate. |
| Med% | numeric | Medium-contact rate. |
| Hard% | numeric | Hard-contact rate. |
| xwOBA | numeric | Expected weighted on-base average. |
| xAVG | numeric | Expected batting average. |
| xSLG | numeric | Expected slugging percentage. |
| pfxFA% | numeric | PITCHf/x four-seam fastball usage rate. |
| pfxFC% | numeric | PITCHf/x cutter usage rate. |
| pfxFS% | numeric | PITCHf/x splitter usage rate. |
| pfxFO% | numeric | PITCHf/x forkball usage rate. |
| pfxSI% | numeric | PITCHf/x sinker usage rate. |
| pfxSL% | numeric | PITCHf/x slider usage rate. |
| pfxCU% | numeric | PITCHf/x curveball usage rate. |
| pfxKC% | numeric | PITCHf/x knuckle curve usage rate. |
| pfxCH% | numeric | PITCHf/x changeup usage rate. |
| pfxSLO% | numeric | PITCHf/x slurve usage rate. |
| pfxST% | numeric | PITCHf/x sweeper usage rate. |
| pfxCUO% | numeric | PITCHf/x other curve usage rate. |
| pfxCV% | numeric | PITCHf/x curve usage rate. |
| pfxvFA | numeric | PITCHf/x average four-seam fastball velocity (mph). |
| pfxvFC | numeric | PITCHf/x average cutter velocity (mph). |
| pfxvFS | numeric | PITCHf/x average splitter velocity (mph). |
| pfxvFO | numeric | PITCHf/x average forkball velocity (mph). |
| pfxvSI | numeric | PITCHf/x average sinker velocity (mph). |
| pfxvSL | numeric | PITCHf/x average slider velocity (mph). |
| pfxvCU | numeric | PITCHf/x average curveball velocity (mph). |
| pfxvKC | numeric | PITCHf/x average knuckle curve velocity (mph). |
| pfxvCH | numeric | PITCHf/x average changeup velocity (mph). |
| pfxvSLO | numeric | PITCHf/x average slurve velocity (mph). |
| pfxvST | numeric | PITCHf/x average sweeper velocity (mph). |
| pfxvCUO | numeric | PITCHf/x average other curve velocity (mph). |
| pfxvCV | numeric | PITCHf/x average curve velocity (mph). |
| pfxFA-X | numeric | PITCHf/x horizontal movement of the four-seam fastball (inches). |
| pfxFC-X | numeric | PITCHf/x horizontal movement of the cutter (inches). |
| pfxFS-X | numeric | PITCHf/x horizontal movement of the splitter (inches). |
| pfxFO-X | numeric | PITCHf/x horizontal movement of the forkball (inches). |
| pfxSI-X | numeric | PITCHf/x horizontal movement of the sinker (inches). |
| pfxSL-X | numeric | PITCHf/x horizontal movement of the slider (inches). |
| pfxCU-X | numeric | PITCHf/x horizontal movement of the curveball (inches). |
| pfxKC-X | numeric | PITCHf/x horizontal movement of the knuckle curve (inches). |
| pfxCH-X | numeric | PITCHf/x horizontal movement of the changeup (inches). |
| pfxSLO-X | numeric | PITCHf/x horizontal movement of the slurve (inches). |
| pfxST-X | numeric | PITCHf/x horizontal movement of the sweeper (inches). |
| pfxCUO-X | numeric | PITCHf/x horizontal movement of the other curve (inches). |
| pfxCV-X | numeric | PITCHf/x horizontal movement of the curve (inches). |
| pfxFA-Z | numeric | PITCHf/x vertical movement of the four-seam fastball (inches). |
| pfxFC-Z | numeric | PITCHf/x vertical movement of the cutter (inches). |
| pfxFS-Z | numeric | PITCHf/x vertical movement of the splitter (inches). |
| pfxFO-Z | numeric | PITCHf/x vertical movement of the forkball (inches). |
| pfxSI-Z | numeric | PITCHf/x vertical movement of the sinker (inches). |
| pfxSL-Z | numeric | PITCHf/x vertical movement of the slider (inches). |
| pfxCU-Z | numeric | PITCHf/x vertical movement of the curveball (inches). |
| pfxKC-Z | numeric | PITCHf/x vertical movement of the knuckle curve (inches). |
| pfxCH-Z | numeric | PITCHf/x vertical movement of the changeup (inches). |
| pfxSLO-Z | numeric | PITCHf/x vertical movement of the slurve (inches). |
| pfxST-Z | numeric | PITCHf/x vertical movement of the sweeper (inches). |
| pfxCUO-Z | numeric | PITCHf/x vertical movement of the other curve (inches). |
| pfxCV-Z | numeric | PITCHf/x vertical movement of the curve (inches). |
| pfxwFA | numeric | PITCHf/x total runs above average on the four-seam fastball. |
| pfxwFC | numeric | PITCHf/x total runs above average on the cutter. |
| pfxwFS | numeric | PITCHf/x total runs above average on the splitter. |
| pfxwFO | numeric | PITCHf/x total runs above average on the forkball. |
| pfxwSI | numeric | PITCHf/x total runs above average on the sinker. |
| pfxwSL | numeric | PITCHf/x total runs above average on the slider. |
| pfxwCU | numeric | PITCHf/x total runs above average on the curveball. |
| pfxwKC | numeric | PITCHf/x total runs above average on the knuckle curve. |
| pfxwCH | numeric | PITCHf/x total runs above average on the changeup. |
| pfxwSLO | numeric | PITCHf/x total runs above average on the slurve. |
| pfxwST | numeric | PITCHf/x total runs above average on the sweeper. |
| pfxwCUO | numeric | PITCHf/x total runs above average on the other curve. |
| pfxwCV | numeric | PITCHf/x total runs above average on the curve. |
| pfxwFA/C | numeric | PITCHf/x runs above average per 100 four-seam fastballs. |
| pfxwFC/C | numeric | PITCHf/x runs above average per 100 cutters. |
| pfxwFS/C | numeric | PITCHf/x runs above average per 100 splitters. |
| pfxwFO/C | numeric | PITCHf/x runs above average per 100 forkballs. |
| pfxwSI/C | numeric | PITCHf/x runs above average per 100 sinkers. |
| pfxwSL/C | numeric | PITCHf/x runs above average per 100 sliders. |
| pfxwCU/C | numeric | PITCHf/x runs above average per 100 curveballs. |
| pfxwKC/C | numeric | PITCHf/x runs above average per 100 knuckle curves. |
| pfxwCH/C | numeric | PITCHf/x runs above average per 100 changeups. |
| pfxwSLO/C | numeric | PITCHf/x runs above average per 100 slurves. |
| pfxwST/C | numeric | PITCHf/x runs above average per 100 sweepers. |
| pfxwCUO/C | numeric | PITCHf/x runs above average per 100 other curves. |
| pfxwCV/C | numeric | PITCHf/x runs above average per 100 curves. |
| pfxaaFA | numeric | PITCHf/x average spin/active component on the four-seam fastball. |
| pfxaaFC | numeric | PITCHf/x average spin/active component on the cutter. |
| pfxaaFS | numeric | PITCHf/x average spin/active component on the splitter. |
| pfxaaFO | numeric | PITCHf/x average spin/active component on the forkball. |
| pfxaaSI | numeric | PITCHf/x average spin/active component on the sinker. |
| pfxaaSL | numeric | PITCHf/x average spin/active component on the slider. |
| pfxaaCU | numeric | PITCHf/x average spin/active component on the curveball. |
| pfxaaKC | numeric | PITCHf/x average spin/active component on the knuckle curve. |
| pfxaaCH | numeric | PITCHf/x average spin/active component on the changeup. |
| pfxaaSLO | numeric | PITCHf/x average spin/active component on the slurve. |
| pfxaaST | numeric | PITCHf/x average spin/active component on the sweeper. |
| pfxaaCUO | numeric | PITCHf/x average spin/active component on the other curve. |
| pfxaaCV | numeric | PITCHf/x average spin/active component on the curve. |
| pfxspFA | numeric | PITCHf/x average spin rate on the four-seam fastball (rpm). |
| pfxspFC | numeric | PITCHf/x average spin rate on the cutter (rpm). |
| pfxspFS | numeric | PITCHf/x average spin rate on the splitter (rpm). |
| pfxspFO | numeric | PITCHf/x average spin rate on the forkball (rpm). |
| pfxspSI | numeric | PITCHf/x average spin rate on the sinker (rpm). |
| pfxspSL | numeric | PITCHf/x average spin rate on the slider (rpm). |
| pfxspCU | numeric | PITCHf/x average spin rate on the curveball (rpm). |
| pfxspKC | numeric | PITCHf/x average spin rate on the knuckle curve (rpm). |
| pfxspCH | numeric | PITCHf/x average spin rate on the changeup (rpm). |
| pfxspSLO | numeric | PITCHf/x average spin rate on the slurve (rpm). |
| pfxspST | numeric | PITCHf/x average spin rate on the sweeper (rpm). |
| pfxspCUO | numeric | PITCHf/x average spin rate on the other curve (rpm). |
| pfxspCV | numeric | PITCHf/x average spin rate on the curve (rpm). |
| pfxO-Swing% | numeric | PITCHf/x Swing rate on pitches outside the zone. |
| pfxZ-Swing% | numeric | PITCHf/x Swing rate on pitches in the zone. |
| pfxSwing% | numeric | PITCHf/x Overall swing rate. |
| pfxO-Contact% | numeric | PITCHf/x Contact rate on pitches outside the zone. |
| pfxZ-Contact% | numeric | PITCHf/x Contact rate on pitches in the zone. |
| pfxContact% | numeric | PITCHf/x Overall contact rate. |
| pfxZone% | numeric | PITCHf/x Rate of pitches in the strike zone. |
| pfxPace | numeric | PITCHf/x Average seconds between pitches. |
| AvgBatSpeed | numeric | Average bat speed (mph). |
| FastSwing% | numeric | Rate of fast swings. |
| SwingLength | numeric | Average swing length (feet). |
| SquaredUpContact% | numeric | Squared-up rate per contact. |
| SquaredUpSwing% | numeric | Squared-up rate per swing. |
| BlastContact% | numeric | Blast rate per contact. |
| BlastSwing% | numeric | Blast rate per swing. |
| Swords | numeric | Swords (especially ugly swinging strikeouts). |
| CompetitiveSwings | numeric | Competitive swings. |
| Tilt | numeric | Average swing tilt (degrees). |
| AttackAngle | numeric | Average attack angle (degrees). |
| AttackDirection | numeric | Average attack direction (degrees). |
| IdealAttackAngle% | numeric | Rate of swings in the ideal attack-angle range. |
| DepthInBox | numeric | Average depth in the batter's box (inches). |
| DistanceOffPlate | numeric | Average distance off the plate (inches). |
| scH-Swing% | numeric | Statcast heart-zone swing rate. |
| scH-Contact% | numeric | Statcast heart-zone contact rate. |
| scH-Zone% | numeric | Statcast heart-zone zone rate. |
| scS-Swing% | numeric | Statcast shadow-zone swing rate. |
| scS-Contact% | numeric | Statcast shadow-zone contact rate. |
| scS-Zone% | numeric | Statcast shadow-zone zone rate. |
| scC-Swing% | numeric | Statcast chase-zone swing rate. |
| scC-Contact% | numeric | Statcast chase-zone contact rate. |
| scC-Zone% | numeric | Statcast chase-zone zone rate. |
| scW-Swing% | numeric | Statcast waste-zone swing rate. |
| scW-Contact% | numeric | Statcast waste-zone contact rate. |
| scW-Zone% | numeric | Statcast waste-zone zone rate. |
| scSI-Swing% | numeric | Statcast in-zone strike-zone swing rate. |
| scSI-Contact% | numeric | Statcast in-zone strike-zone contact rate. |
| scSI-Zone% | numeric | Statcast in-zone strike-zone zone rate. |
| scSO-Swing% | numeric | Statcast out-of-zone strike-zone swing rate. |
| scSO-Contact% | numeric | Statcast out-of-zone strike-zone contact rate. |
| scSO-Zone% | numeric | Statcast out-of-zone strike-zone zone rate. |
| scO-Swing% | numeric | Statcast out-of-zone-zone swing rate. |
| scO-Contact% | numeric | Statcast out-of-zone-zone contact rate. |
| scO-Zone% | numeric | Statcast out-of-zone-zone zone rate. |
| scZ-Swing% | numeric | Statcast in-zone-zone swing rate. |
| scZ-Contact% | numeric | Statcast in-zone-zone contact rate. |
| scZ-Zone% | numeric | Statcast in-zone-zone zone rate. |
| piCH% | numeric | PITCHInfo changeup usage rate. |
| piCS% | numeric | PITCHInfo slow curve usage rate. |
| piCU% | numeric | PITCHInfo curveball usage rate. |
| piFA% | numeric | PITCHInfo four-seam fastball usage rate. |
| piFC% | numeric | PITCHInfo cutter usage rate. |
| piFS% | numeric | PITCHInfo splitter usage rate. |
| piSI% | numeric | PITCHInfo sinker usage rate. |
| piSL% | numeric | PITCHInfo slider usage rate. |
| piXX% | numeric | PITCHInfo unknown/other pitch usage rate. |
| pivCH | numeric | PITCHInfo average changeup velocity (mph). |
| pivCS | numeric | PITCHInfo average slow curve velocity (mph). |
| pivCU | numeric | PITCHInfo average curveball velocity (mph). |
| pivFA | numeric | PITCHInfo average four-seam fastball velocity (mph). |
| pivFC | numeric | PITCHInfo average cutter velocity (mph). |
| pivFS | numeric | PITCHInfo average splitter velocity (mph). |
| pivSI | numeric | PITCHInfo average sinker velocity (mph). |
| pivSL | numeric | PITCHInfo average slider velocity (mph). |
| pivXX | numeric | PITCHInfo average unknown/other pitch velocity (mph). |
| piCH-X | numeric | PITCHInfo horizontal movement of the changeup (inches). |
| piCS-X | numeric | PITCHInfo horizontal movement of the slow curve (inches). |
| piCU-X | numeric | PITCHInfo horizontal movement of the curveball (inches). |
| piFA-X | numeric | PITCHInfo horizontal movement of the four-seam fastball (inches). |
| piFC-X | numeric | PITCHInfo horizontal movement of the cutter (inches). |
| piFS-X | numeric | PITCHInfo horizontal movement of the splitter (inches). |
| piSI-X | numeric | PITCHInfo horizontal movement of the sinker (inches). |
| piSL-X | numeric | PITCHInfo horizontal movement of the slider (inches). |
| piXX-X | numeric | PITCHInfo horizontal movement of the unknown/other pitch (inches). |
| piCH-Z | numeric | PITCHInfo vertical movement of the changeup (inches). |
| piCS-Z | numeric | PITCHInfo vertical movement of the slow curve (inches). |
| piCU-Z | numeric | PITCHInfo vertical movement of the curveball (inches). |
| piFA-Z | numeric | PITCHInfo vertical movement of the four-seam fastball (inches). |
| piFC-Z | numeric | PITCHInfo vertical movement of the cutter (inches). |
| piFS-Z | numeric | PITCHInfo vertical movement of the splitter (inches). |
| piSI-Z | numeric | PITCHInfo vertical movement of the sinker (inches). |
| piSL-Z | numeric | PITCHInfo vertical movement of the slider (inches). |
| piXX-Z | numeric | PITCHInfo vertical movement of the unknown/other pitch (inches). |
| piwCH | numeric | PITCHInfo total runs above average on the changeup. |
| piwCS | numeric | PITCHInfo total runs above average on the slow curve. |
| piwCU | numeric | PITCHInfo total runs above average on the curveball. |
| piwFA | numeric | PITCHInfo total runs above average on the four-seam fastball. |
| piwFC | numeric | PITCHInfo total runs above average on the cutter. |
| piwFS | numeric | PITCHInfo total runs above average on the splitter. |
| piwSI | numeric | PITCHInfo total runs above average on the sinker. |
| piwSL | numeric | PITCHInfo total runs above average on the slider. |
| piwXX | numeric | PITCHInfo total runs above average on the unknown/other pitch. |
| piwCH/C | numeric | PITCHInfo runs above average per 100 changeups. |
| piwCS/C | numeric | PITCHInfo runs above average per 100 slow curves. |
| piwCU/C | numeric | PITCHInfo runs above average per 100 curveballs. |
| piwFA/C | numeric | PITCHInfo runs above average per 100 four-seam fastballs. |
| piwFC/C | numeric | PITCHInfo runs above average per 100 cutters. |
| piwFS/C | numeric | PITCHInfo runs above average per 100 splitters. |
| piwSI/C | numeric | PITCHInfo runs above average per 100 sinkers. |
| piwSL/C | numeric | PITCHInfo runs above average per 100 sliders. |
| piwXX/C | numeric | PITCHInfo runs above average per 100 unknown/other pitchs. |
| piO-Swing% | numeric | PITCHInfo Swing rate on pitches outside the zone. |
| piZ-Swing% | numeric | PITCHInfo Swing rate on pitches in the zone. |
| piSwing% | numeric | PITCHInfo Overall swing rate. |
| piO-Contact% | numeric | PITCHInfo Contact rate on pitches outside the zone. |
| piZ-Contact% | numeric | PITCHInfo Contact rate on pitches in the zone. |
| piContact% | numeric | PITCHInfo Overall contact rate. |
| piZone% | numeric | PITCHInfo Rate of pitches in the strike zone. |
| Events | numeric | Batted-ball events with Statcast data. |
| EV | numeric | Average exit velocity (mph). |
| LA | numeric | Average launch angle (degrees). |
| Barrels | numeric | Barreled batted balls. |
| Barrel% | numeric | Barrel rate (per batted-ball event). |
| maxEV | numeric | Maximum exit velocity (mph). |
| HardHit | numeric | Hard-hit batted balls (95+ mph). |
| HardHit% | numeric | Hard-hit rate (95+ mph). |
| gamedate | character | Game date as parsed from the source feed. |
| dh | integer | Doubleheader game indicator (0 = single game). |
Examples
try(fg_batter_game_logs(playerid = 19755, year = 2023))
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.