EdSurvey (version 2.2.3)

readECLS_K1998: Connect to ECLS-K 1998 Data

Description

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

Usage

readECLS_K1998(path = getwd(),
  filename = "eclsk_98_99_k8_child_v1_0.dat",
  layoutFilename = "Layout_k8_child.txt", forceReread = FALSE,
  verbose = TRUE)

Arguments

path

a character value to the full directory path(s) to the ECLS-K 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-K1998 function is running to indicate processing progress. The default value is TRUE.

Value

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

Details

Reads in the unzipped files downloaded from the ECLS-K 1998 longitudinal database(s) to an edsurvey.data.frame. The ECLS-K 1998-1999 study consisted of three distinct separate datasets that cannot be combined: (1) Child Grades K-8; (2) School Base Year Data; (3) Teacher Base Year Data. The filename and layoutFilename arguments are defaulted to the corresponding Child K-8 default filenames.

See Also

readECLS_K2011, readNAEP, getData, downloadECLS_K

Examples

# NOT RUN {
#read-in student file with defaults
eclsk_df <- readECLS_K1998(path="C:/ECLS_K/1998") #using defaults
d <- getData(eclsk_df, c("childid", "gender", "race"))
summary(d)

#read-in with parameters specified
eclsk_df <- readECLS_K1998(path = "C:/ECLS_K1998", 
                           filename = "eclsk_98_99_k8_child_v1_0.dat", 
                           layoutFilename = "Layout_k8_child.txt", 
                           verbose = TRUE, 
                           forceReread = FALSE)
# }