Uses an Internet connection to download PIRLS data. Data come from timssandpirls.bc.edu zip files. This function works for 2001, 2006, 2011, 2016, and 2021 data.
Usage
downloadPIRLS(
root,
years = c(2001, 2006, 2011, 2016, 2021),
cache = FALSE,
verbose = TRUE
)Arguments
- root
a character string indicating the directory where the PIRLS data should be stored. Files are placed in a subdirectory named PIRLS/[year].
- years
an integer vector of the assessment years to download. Valid years are 2001, 2006, 2011, 2016, and 2021.
- cache
a logical value set to process and cache the text (.txt) version of files. This takes a very long time but saves time for future uses of the data. Default value is
FALSE.- verbose
a logical value to either print or suppress status message output. The default value is
TRUE.
Examples
if (FALSE) { # \dontrun{
# root argument will vary by operating system conventions
downloadPIRLS(year=c(2006, 2011), root = "~/")
# cache=TRUE will download then process the datafiles
downloadPIRLS(year=2011, root = "~/", cache = TRUE)
# set verbose=FALSE for silent output
# if year not specified, download all years
downloadPIRLS(root="~/", verbose = FALSE)
} # }