Downloads and processes enrollment data from the Massachusetts Department of Elementary and Secondary Education (DESE) via their Socrata API (educationtocareer.data.mass.gov).
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 1994-2026.
- tidy
If TRUE (default), returns data in long (tidy) format with subgroup column. If FALSE, returns wide format.
- use_cache
If TRUE (default), uses locally cached data when available. Set to FALSE to force re-download from DESE.
Value
Data frame with enrollment data. Wide format includes columns for district_id, campus_id, names, and enrollment counts by demographic/grade. Tidy format pivots these counts into subgroup and grade_level columns.
Examples
if (FALSE) { # \dontrun{
# Get 2025 enrollment data (2024-25 school year)
enr_2025 <- fetch_enr(2025)
# Get historical data from 2000
enr_2000 <- fetch_enr(2000)
# Get wide format
enr_wide <- fetch_enr(2024, tidy = FALSE)
# Force fresh download (ignore cache)
enr_fresh <- fetch_enr(2024, use_cache = FALSE)
# Filter to Boston Public Schools
boston <- enr_2025 |>
dplyr::filter(district_id == "0035")
} # }