EdSurvey (version 2.2.3)

readECLS_K2011: Connect to ECLS-K 2011 Data

Description

Opens a connection to an ECLS-K 2011 data file and returns an edsurvey.data.frame with information about the file and data.

Usage

readECLS_K2011(path = getwd(), filename = "childK4p.dat",
  layoutFilename = "ECLSK2011_K4PUF.sps", forceReread = FALSE,
  verbose = TRUE)

Arguments

path

a character value to the full directory path(s) to the ECLS-K 2010-2011 extracted fixed-with-format (.dat) set of data files

filename

a character value of the name of the fixed-width-file (.dat) data file in the specified path to be read

layoutFilename

a character value of the filename of either the ASCII text (.txt) layout file of the filename within the specified path, OR a character value of the filename of the SPSS syntax (.sps) layout file of the filename within the specified path

forceReread

a logical value to force re-reading of all processed data. The default value of FALSE will speed up the read function by using existing read-in data already processed.

verbose

a logical value that will determine if you want verbose output while the readECLS-K2011 function is running to indicate processing progress. The default value is TRUE.

Value

an edsurvey.data.frame for the ECLS-K 2010-2011 longitudinal dataset

Details

Reads in the unzipped files downloaded from the ECLS-K 2010-2011 longitudinal database.

See Also

readECLS_K1998, readNAEP, getData, and downloadECLS_K

Examples

# NOT RUN {
#read-in student file with defaults
eclsk_df <- readECLS_K2011(path="C:/ECLS_K/2011") #using defaults
d <- getData(eclsk_df, c("childid", "c1hgt1", "c1wgt1"))
summary(d)

#read-in with parameters specified
eclsk_df <- readECLS_K2011(path = "C:/ECLS_K2011",
                           filename = "childK4p.dat",
                           layoutFilename = "ECLSK2011_K4PUF.sps",
                           forceReread = FALSE,
                           verbose = TRUE) 
# }