Skip to contents

Fetch Illinois assessment data

Source: R/fetch_assessment.R
fetch_assessment.Rd

Downloads and returns assessment data from the Illinois State Board of Education. Includes ISAT (2006-2014), PARCC (2015-2018), and IAR (2019+) assessments.

Usage

fetch_assessment(end_year, tidy = TRUE, use_cache = TRUE)

Arguments

end_year

School year end (2023-24 = 2024). Valid range: 2006-2025.

tidy

If TRUE (default), returns data in long format with subject column. If FALSE, returns wide format with separate pct_proficient_* columns.

use_cache

If TRUE (default), uses locally cached data when available.

Value

Data frame with assessment data

Details

Assessment systems:

  • IAR (2019-present): Illinois Assessment of Readiness

    • Proficiency levels 1-5 (4+5 = proficient)

    • Grades 3-8 tested in ELA and Math

  • PARCC (2015-2018): Partnership for Assessment of Readiness

    • Proficiency levels 1-5 (4+5 = proficient)

    • Grades 3-8 tested

  • ISAT (2006-2014): Illinois Standards Achievement Test

    • Proficiency categories: Not Meeting, Below, Meeting, Exceeding

    • Grades 3-8 tested

  • 2020: No data (COVID-19 testing waiver)

Examples

if (FALSE) { # \dontrun{
# Get 2024 IAR assessment data
assess_2024 <- fetch_assessment(2024)

# Get 2017 PARCC data in wide format
parcc_2017 <- fetch_assessment(2017, tidy = FALSE)

# Force fresh download
assess_fresh <- fetch_assessment(2024, use_cache = FALSE)
} # }