Get, Parse, and Format Retrosheet Event and Roster FilesSource:
This function requires the use of the
Chadwick CLI. Follow
the directions at the repository for installation of the CLI release for your platform.
Specifically from the
Chadwick CLI tools, this function requires the
cwevent application to be available from the command line.
For unix platform users: the
retrosheet_data() function uses the
system() interface under the hood.
For Windows and other platform users: the
retrosheet_data() function interacts with the
shell() interface under the hood.
retrosheet_data( path_to_directory = NULL, years_to_acquire = most_recent_mlb_season() - 1, sequence_years = FALSE )
(default: NULL) A file path that if set, either:
creates a new directory, or
uses the path to an existing directory
(format: YYYY) The seasons to collect. Single, multiple, and sequential years can be passed. If passing multiple years, enclose in a vector (i.e. c(2017,2018)). Defaults to
(logical, default: FALSE): If the seasons passed in the years_to_acquire parameter should be sequenced so that the function returns all years including and between the vector passed, set the argument to TRUE. Defaults to FALSE.
path_to_directory is not set (default), the process will return a named list
of tibbles: 'events' and 'rosters' for each season provided to
path_to_directory is set, will also write two csv files to the unzipped directory: 1) a combined csv
of the event data for a given year and 2) a combined csv of each team's
roster for each year provided to