Fetch assessment data for multiple years — fetch_assessment

Downloads and combines assessment data for multiple school years. Note: 2020 is automatically excluded (COVID-19 testing waiver).

Usage

fetch_assessment_multi(end_years, level = "all", tidy = TRUE, use_cache = TRUE)

Arguments

end_years: Vector of school year ends (e.g., c(2022, 2023, 2024))
level: Level of data to fetch: "all" (default), "state_lea", or "school"
tidy: If TRUE (default), returns data in long (tidy) format.
use_cache: If TRUE (default), uses locally cached data when available.

Value

Combined data frame with assessment data for all requested years

Examples

if (FALSE) { # \dontrun{
# Get 3 years of data
assess_multi <- fetch_assessment_multi(2022:2024)

# Get post-COVID recovery years
recovery <- fetch_assessment_multi(2021:2024)

# Track proficiency trends at state level
assess_multi |>
  dplyr::filter(is_state, subject == "Math", grade == "All") |>
  dplyr::filter(proficiency_level %in% c("mastery", "advanced")) |>
  dplyr::group_by(end_year) |>
  dplyr::summarize(pct_proficient = sum(pct, na.rm = TRUE))
} # }