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.
- Key Functions
- Guides and Tutorials
- Data Set-Specific Overviews
- Task-Specific Walkthroughs
- Methodology Resources
Using Ed Survey
Installing and Loading
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.
Guides and Tutorials
- Analyzing NCES Data Using EdSurvey: A User’s Guide
- Introduction to using EdSurvey R Package for Analyzing NCES Large-Scale Data Sets
- EdSurvey: Analyzing Large-Scale Assessment Data – Using NAEP and TIMSS Data as Examples
- EdSurvey: Analysis of the Early Childhood Longitudinal Study, Kindergarten Class of 2010‒11
- Using EdSurvey to Analyse PIAAC Data
Data Set-Specific Overviews
Documents that describe the analysis of specific survey data in the EdSurvey package include the following:
- Using EdSurvey to Analyze ECLS-K:2011 Data (PDF), which covers topics such as preparing the R environment, downloading and processing the data, exploring and manipulating data, and running statistical analyses such as summary tables, correlations, and regression models
- Using EdSurvey to Analyze NCES Data: An Illustration of Analyzing NAEP Primer (PDF), which covers topics such as preparing the R environment, downloading and processing the data, exploring and manipulating data, and running statistical analyses such as summary tables, correlations, and regression models.
- Using EdSurvey to Analyze TIMSS Data (PDF), which covers topics such as preparing the R environment for processing, creating summary tables, running linear regression models, and correlating variables.
- Using EdSurvey to Analyze NAEP Data With and Without Accommodations (PDF), which provides an overview of handling NAEP assessment data with and without accommodations and describes methods used to analyze this data.
Task-Specific Walkthroughs
Documents providing an overview of functions developed in the EdSurvey package include the following:
- NAEP DBA-PBA Linking Error With EdSurvey (PDF), which describes how to use EdSurvey to calculate the linking error in NAEP assessments that have combined DBA and PBA formats as well as the NCES method that EdSurvey uses to calculate the linking error.
- Installing the EdSurvey Package on a Restricted-Use Data Computer (PDF), which provides guidance on how to install EdSurvey on a restricted-use data computer without an internet connection.
- Converting Text Data File(s) With Companion SPSS Script to SPSS Data File Format (PDF), which details the process of converting a data file and SPSS script to an SPSS data file for use with EdSurvey
- Using the getData Function in EdSurvey (PDF), which describes the use of the EdSurvey package when extensive data manipulation is required before analysis.
- Using EdSurvey for Trend Analysis (PDF), which describes the methods used in the EdSurvey package to conduct analyses of statistics that change over time in large-scale educational studies.
- Exploratory Data Analysis on NCES Data (PDF), which provides examples of conducting exploratory data analysis on NAEP data
- Calculating Adjusted p-Values From EdSurvey Results (PDF), which describes the basics of adjusting p-values to account for multiple comparisons.
- Producing LaTeX Tables From edsurveyTable Results With edsurveyTable2pdf (PDF), which details the creation of PDF summary tables from summary results using the edsurveyTable2pdf function.
Methodology Resources
Documents that describe the statistical methodology used in the EdSurvey package include the following:
- Statistical Methods (PDF), which details estimation procedures of the statistics in the lm.sdf, achievementLevel, and edsurveyTable functions.
- Analyses Using Achievement Levels Based on Plausible Values, which describes the methodology for NAEP achievement level estimation.
- Gap Analysis (PDF), which covers methods for comparing the difference between two statistics for two groups that potentially share members.
- Estimating Percentiles (PDF), which describes the methods used to estimate percentiles.
- Estimating Mixed-Effects Models (PDF), which describes the methods used to estimate mixed-effects models with plausible values and survey weights and how to fit different types of mixed-effects models using the EdSurvey package.
- Multivariate Regression (PDF), which details the estimation of multivariate regression models using mvrlm.sdf.
- Running Wald Tests (PDF), which details the use of the Wald test to exam the joint significance of regression coefficients using lm.sdf and glm.sdf.
- Weighted and Unweighted Correlation Methods for Large-Scale Educational Assessment: wCorr Formulas, which introduces the methodology used by the wCorr R package for computing the Pearson, Spearman, polyserial, polyserial, polychoric and tetrachoric correlations, with and without weights applied, and presents simulation evidence to show correctness of the methods, including an examination of bias and consistency.