Downloads and processes MAP (Missouri Assessment Program) assessment data from the Missouri Department of Elementary and Secondary Education (DESE).
Arguments
- end_year
A school year. Year is the end of the academic year - eg 2023-24 school year is year '2024'. Valid values are 2015-2019, 2021-2024.
- level
Level of data to fetch: "all" (default), "state", "district", or "school"
- tidy
If TRUE (default), returns data in long (tidy) format with proficiency_level column. If FALSE, returns wide format with separate pct_* columns.
- use_cache
If TRUE (default), uses locally cached data when available. Set to FALSE to force re-download from DESE.
Value
Data frame with assessment data. Wide format includes columns for proficiency percentages (pct_below_basic, pct_basic, pct_proficient, pct_advanced). Tidy format pivots these into proficiency_level and pct columns.
Details
Data is available from 2015-2024, excluding 2020 (COVID-19 testing waiver). Assessment data includes proficiency levels (Below Basic, Basic, Proficient, Advanced) for subjects including ELA, Math, Science, and EOC courses.
Examples
if (FALSE) { # \dontrun{
# Get 2024 assessment data (2023-24 school year)
assess_2024 <- fetch_assessment(2024)
# Get only state-level data
state_assess <- fetch_assessment(2024, level = "state")
# Get wide format (pct columns not pivoted)
assess_wide <- fetch_assessment(2024, tidy = FALSE)
# Force fresh download (ignore cache)
assess_fresh <- fetch_assessment(2024, use_cache = FALSE)
# Filter to math results
math_results <- assess_2024 |>
dplyr::filter(subject == "Math", is_state)
} # }