EdSurvey (version 2.2.3)

readTALIS: Connect to TALIS Data

Description

Opens a connection to a TALIS data file and returns an edsurvey.data.frame with information about the file and data.

Usage

readTALIS(path, countries, isced = "b", dataLevel = "teacher",
  forceReread = FALSE, verbose = TRUE)

Arguments

path

a character vector to the full directory path(s) to the TALIS SPSS files (.sav)

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 in the TALIS codebook or you can use https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes. You can use * to indicate all countries available.

isced

a character value that is one of a, b, or c. a stands for Primary Level, b is for Lower Secondary Level; and, c is for Upper Secondary Level. Default to b.

dataLevel

a character value that indicates which data level to be used. It can be teacher (the default) or school.

forceReread

a logical value to force rereading of all processed data. Defaults to FALSE. Setting forceReread to be TRUE will cause PISA data to be reread and increase processing time.

verbose

a logical value that will determine if you want verbose output while the function is running to indicate the progress. Defaults to 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 TALIS database using the OECD Repository (http://www.oecd.org/skills/piaac/). If dataLevel is set to be teacher, it treats the teacher data file as the main dataset and merges school data into teacher data for each country. If dataLevel is school, it uses only the school data file. To conduct a school-level analysis with teacher variables, it is recommended that users aggregate teacher-level data first before merging it to school files.

References

Organisation for Economic Co-operation and Development. (2014a). TALIS 2013 technical report. Paris, France: Author. Retrieved from http://www.oecd.org/education/school/TALIS-technical-report-2013.pdf

See Also

getData and downloadTALIS

Examples

# NOT RUN {
# The following call returns an edsurvey.data.frame to TALIS 2013 
# for US teacher-level data at secondary level
usa2013 <- readTALIS(path = "C:/TALIS/2013", isced = "b",
                     dataLevel = "teacher", countries = "usa")

# Extract a data.frame with a few variables
gg <- getData(usa2013, c("tt2g05b", "tt2g01"))  
head(gg)

# Conduct a preliminary analysis on the edsurvey.data.frame
edsurveyTable(tt2g05b ~ tt2g01, data = usa2013) 
# }