Analysis of NCES Education Survey and Assessment Data
Overview
Read in and analyze functions for education survey and assessment data from the National Center for Education Statistics (NCES) https://nces.ed.gov/, including National Assessment of Educational Progress (NAEP) data https://nces.ed.gov/nationsreportcard/ and data from the International Assessment Database: Organisation for Economic Co-operation and Development (OECD) https://www.oecd.org/, including Programme for International Student Assessment (PISA), Teaching and Learning International Survey (TALIS), Programme for the International Assessment of Adult Competencies (PIAAC), and International Association for the Evaluation of Educational Achievement (IEA) https://www.iea.nl/, including Trends in International Mathematics and Science Study (TIMSS), TIMSS Advanced, Progress in International Reading Literacy Study (PIRLS), International Civic and Citizenship Study (ICCS), International Computer and Information Literacy Study (ICILS), and Civic Education Study (CivEd).
UPDATES
readNAEPfunction now supports analyzing the following NAEP data products:- the main NAEP data up to 2022
- NAEP long-term trend data up to 2023
- the 2022 Monthly School Survey (MSS) Linking Study
- the 2021 School and Teacher Questionnaire Special Study.
BUG FIXES
[[<-assignment did not previously work with anedsurvey.data.frameobject. This causes issues when defining new columns with a few possible methods that resulted in newly defined columns not being returned bygetData. Thanks to Tao Jiang for identifying this bug.
From inst/NEWS.Rd in the release
Install
Health
NOTER code for possible problemsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64
Found calls to structure() using deprecated special names: EdSurvey/tests/testthat/REF-0-main.R (.Dim: 1, .Dimnames: 1, .Names: 1) EdSurvey/tests/testthat/test-10-main.R (.Dim: 1, .Dimnames: 1, .Names: 1) '.Dim' should be changed to 'dim'. '.Dimnames' should be changed to 'dimnames'. '.Names' should be changed to 'names'.
- NOTE8 OK, 5 NOTENow
- NOTE10 OK, 3 NOTE2026-07-16
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK14 OK2026-03-10
Documentation
- Help pages
- 98 (3 internal)includes a package overview page
- Examples that run
- 0%77 never run
- Exported functions with examples
- 90%
- Documented parameters
- 99%
- Return-value docs
- 73%
- Help pages citing references
- 14%
Downloads
Repository
- PRs merged (all time)
- 88%
- Median days to close, 50 most recently updated closed issues
- 6
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Issues over time
PRs over time
6 development-tooling and community-health practices detected across 2 families in the upstream repository
Checks run against github.com/american-institutes-for-research/edsurvey on 2026-10-25.
Dependencies
Installing EdSurvey adds 91 packages (47 with compiled code, 73 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
Code & Tests
Datasets
People & History
Show 3 peopleHide 3 people
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- 4.0.7Latest
- 4.0.6
- RR 4.4.0 released · 2024-04-24
- 4.0.4
- 4.0.12023-06-14 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 3.1.02023-03-21 · diff ↗
- 3.0.2
- 3.0.12022-10-06 · diff ↗
- 3.0.02022-09-23 · diff ↗ ·
added 6 exports
defaultNAEPScoreCard, defaultTIMSSScoreDict, getAllItems, scoreDefault, scoreTIMSS, suggestWeights - RR 4.2.0 released · 2022-04-22
- 2.7.12021-10-05 · diff ↗ ·
added 6 exports
downloadNHES, downloadSSOCS, getNHES_SurveyInfo, readNHES, readSSOCS, viewNHES_SurveyCodes - 2.7.0
- RR 4.1.0 released · 2021-05-18
Show 17 earlier eventsHide 17 earlier events
- 2.6.92021-03-23 · diff ↗
- 2.6.1
- RR 4.0.0 released · 2020-04-24
- 2.5.0
- 2.4.02020-01-10 · diff ↗ ·
removed 2 exports
readBB_2001, readBB_2012added 7 exports
SD, downloadELS, downloadHSLS, getPSUVar, getStratumVar, readELS, readHSLS - RR 3.6.0 released · 2019-04-26
- 2.3.2
- unarchivedReturned to CRAN2019-03-18
- 2.2.32019-03-18 · diff ↗
- archivedRemoved from CRAN2019-03-05requires archived package 'WeMix'
- 2.2.22018-11-19 · diff ↗
- 2.2.12018-11-19 · diff ↗ ·
added 14 exports
downloadECLS_K, download_ePIRLS, edsurvey.data.frame, getAttributes, mixed.sdf, mvrlm.sdf, oddsRatio, readECLS_K1998, readECLS_K2011, read_ePIRLS, rebindAttributes, setAttributes, summary2, waldTest - 2.0.32018-05-16 · diff ↗ ·
added 33 exports
DoFCorrection, append.edsurvey.data.frame.list, cbind, contourPlot, downloadCivEDICCS, downloadICILS, downloadPIAAC, downloadPIRLS, downloadPISA, downloadTALIS, downloadTIMSS, downloadTIMSSAdv, edsurvey.data.frame.list, edsurveyTable2pdf, gap, glm.sdf, logit.sdf, percentile, probit.sdf, rbind, readCivEDICCS, readICILS, readPIAAC, readPIRLS, readPISA, readTALIS, readTIMSS, readTIMSSAdv, recode.sdf, rename.sdf and 3 more - RR 3.5.0 released · 2018-04-23
- 1.0.62017-05-05 · diff ↗
- 1.0.52017-04-26
- RR 3.4.0 released · 2017-04-21
Package metadata
- First published
- 2017-04-26
- Total releases
- 21 / 9 yrs
- License
- GPL-2 OSI
- Minimum R
- ≥ 4.0.0
- Download size
- 1.0 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("EdSurvey")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.