Innovating How Users Access NCES Data

EdSurvey is an R statistical package, within the Data R Project, that is designed to process and analyze national and international education data from the National Center for Education Statistics (NCES). The package takes into account complex sample survey designs, including the use of plausible values, so that users can efficiently and seamlessly work with NCES data.

Using Ed Survey

Installing and Loading

Contact and Bug Reports 
Please report bugs and other issues in our Github repository.

Unless you already have R version 3.5.0 or later, install the latest R version. You also may want to install RStudio desktop, which has an interface that can be easier to follow. 

Inside R, run the following command to install EdSurvey as well as its package dependencies:

install.packages ("EdSurvey")

Once the package is successfully installed, load EdSurvey with the following command:

library(EdSurvey)

The EdSurvey Version 4.1.0 includes data from the following sources:

  • National Assessment of Educational Progress (NAEP) – up to 2024 NAEP
  • NAEP Long Term Trend (LTT) – up to 2023 LTT
  • NAEP High School Transcript Study – 2019
  • NAEP Monthly School Survey Linking Study – 2022
  • NAEP School and Teacher Questionnaire Special Study – 2021
  • Simulated NAEP Grade 8 Mathematics Public-Use Methodological Data File – 2015
  • Trends in International Mathematics and Science Study (TIMSS) and TIMSS Advanced – up to 2019 TIMSS
  • Progress in International Reading Literacy Study (PIRLS) and ePIRLS – up to 2021 PIRLS
  • International Computer and Information Literacy Study (ICILS) – up to 2018 ICILS
  • International Civic and Citizenship Education Study (ICCS) – up to 2016 ICCS
  • Civic Education Study (CivEd) – 1999
  • Program for International Student Assessment (PISA) – up to 2022 PISA
  • PISA Young Adult Follow-up Study
  • Program for the International Assessment of Adult Competencies (PIAAC) – up to cycle 1, rounds 1 to 3 (2017)
  • Teaching and Learning International Survey (TALIS) – up to 2018
  • Early Childhood Longitudinal Studies (ECLS-K: 1998, ECLS-K: 2011, ECLS-B)
  • Education Longitudinal Study (ELS) – 2002
  • High School Longitudinal Study (HSLS) – 2009
  • Beginning Teacher Longitudinal Study (BTLS)
  • Baccalaureate and Beyond Longitudinal Study (B&B)
  • Beginning Postsecondary Students Longitudinal Study (BPS)
  • High School and Beyond (HS&B)
  • National Household Education Surveys Program (NHES)
  • School Survey on Crime and Safety (SSOCS)

Key Functions

The key functions of EdSurvey Version 4.0.7 include the following: 

  • Analyzing achievement levels and benchmarks for NAEP and international assessment data
  • Correlating variables, including Pearson, Spearman, polyserial, polychoric, and correlation between plausible values, with or without weights applied
  • Exploring data using methods to better understand survey attributes and search for variables and levels in codebooks
  • Manipulating data, such as subsetting and merging data, as well as renaming and recoding variables
  • Processing data, including downloading publicly available data and reading data in R
  • Fitting New Conditioning Models direct estimation of student scale scores using the marginal maximum likelihood regression estimation method, an alternative method to the plausible values approach
  • Drawing plausible values to enable researchers to use new data that have been merged onto NCES’s existing data and then use a marginal maximum likelihood model directly; researchers can run any EdSurvey analytical function (e.g., summary tables, regressions) with the new plausible values, which further expands how they can work with NCES data after merging in data beyond information contained on existing surveys
  • Conducting gap analyses to compare the average, percentile, achievement level, or percentage of survey responses between two groups that potentially share members
  • Running linear regression models with or without plausible values as the dependent variable
  • Running logistic regression models that allow either a discrete variable or dichotomized plausible values as the dependent variable
  • Conducting multilevel modeling (linear and binomial) that use weights at multiple levels and allow plausible values in the dependent variable
  • Running quantile regression models that fit a quantile regression model that use weights and variance estimates appropriate for the data
  • Running multivariate regression models that extend multiple linear regression to include models with multiple outcome variables
  • Calculating percentiles of numeric variables or plausible values
  • Implementing the NAEP linking error method to incorporate linking error in variance estimation for NAEP assessments during the transition year from paper-based assessment to digitally based assessment
  • Suggesting weights to assist researchers in deciding which weight to use for analyses of ECLS-K:2011 data
  • Providing summary statistics, including unweighted and weighted totals; conditional means; percentage of respondents in a category (conditional on an ancillary categorical variable or on the interactions of an arbitrary number of categorical variables); and estimation of scale score means based on plausible values

As the development of EdSurvey progresses, several additional functions like item responses theory and other statistical methods, will be added to the package.

Return to top

Data Set-Specific Overviews

Documents that describe the analysis of specific survey data in the EdSurvey package include the following:

Return to top

Task-Specific Walkthroughs

Documents providing an overview of functions developed in the EdSurvey package include the following:

Return to top

Methodology Resources

Documents that describe the statistical methodology used in the EdSurvey package include the following:

Return to top