downloadTIMSSAdv: Download and Unzip TIMSS Advanced Files

View source: R/downloadTIMSSAdv.R

downloadTIMSSAdvR Documentation

Download and Unzip TIMSS Advanced Files

Description

Uses an Internet connection to download TIMSS Advanced data. Data come from timssandpirls.bc.edu zip files. This function works for 1995, 2008, and 2015 data.

Usage

downloadTIMSSAdv(
  root,
  years = c(1995, 2008, 2015),
  cache = FALSE,
  verbose = TRUE
)

Arguments

root

a character string indicating the directory where the TIMSS Advanced data should be stored. Files are placed in a subdirectory named TIMSSAdv/[year].

years

an integer vector of the assessment years to download. Valid years are 1995, 2008, and 2015.

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.

Author(s)

Tom Fink

See Also

readTIMSSAdv

Examples

## Not run: 
# root argument will vary by operating system conventions
downloadTIMSSAdv(year=c(2008, 2015), root = "~/")

# cache=TRUE will download then process the datafiles
downloadTIMSSAdv(year=2015, root = "~/", cache = TRUE)

# set verbose=FALSE for silent output
# if year not specified, download all years
downloadTIMSSAdv(root="~/", verbose = FALSE)

## End(Not run)

EdSurvey documentation built on Nov. 2, 2023, 6:25 p.m.