Connect to ICILS Data

Opens a connection to an ICILS data file residing on the disk and returns an edsurvey.data.frame with information about the file and data.

Usage

readICILS(
  path,
  countries,
  dataSet = c("student", "teacher"),
  forceReread = FALSE,
  verbose = TRUE
)

Arguments

path: a character value to the full directory path to the ICILS extracted SPSS (.sav) set of data
countries: a character vector of the country/countries to include using the three-digit ISO country code. A list of country codes can be found on Wikipedia at https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes or other online sources. Consult the ICILS User Guide to help determine what countries are included within a specific testing year of ICILS. To select all countries, use a wildcard value of *.
dataSet: a character value of either student (the default if not specified) or teacher to indicate which set of data is returned. The student-level and teacher-level datasets cannot both be returned at the same time, unlike other IEA datasets.
forceReread: a logical value to force rereading of all processed data. The default value of FALSE will speed up the readICILS function by using existing read-in data already processed.
verbose: a logical value to either print or suppress status message output. The default value is TRUE.

Value

an edsurvey.data.frame for a single specified country or an edsurvey.data.frame.list if multiple countries specified

Details

Reads in the unzipped files downloaded from the ICILS international dataset(s) using the IEA Study Data Repository. Data files require the SPSS data file (.sav) format using the default filenames.

Author

Tom Fink and Jeppe Bundsgaard (updated for 2018 and 2023)

Examples

if (FALSE) { # \dontrun{
pol <- readICILS("~/ICILS/2013", countries = "pol", dataSet = "student")
gg <- getData(data=pol, varnames=c("idstud", "cil", "is1g18b"))
head(gg)
edsurveyTable(formula=cil ~ is1g18b, pol)
} # }