Fetch Tennessee enrollment data — fetch

Downloads and processes enrollment data from the Tennessee Department of Education data portal.

Usage

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

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 1999-2024.
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 TDOE.

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. Note: Historical years (1999-2011) only include district-level data.

Details

Data is available from 1999-2024:

1999-2011: Historical data from Annual Statistical Report (ASR) - district-level only
2012-2024: Modern data portal - includes school-level data

Examples

if (FALSE) { # \dontrun{
# Get 2024 enrollment data (2023-24 school year)
enr_2024 <- fetch_enr(2024)

# Get historical data from 2005
enr_2005 <- fetch_enr(2005)

# 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 specific district (Knox County)
knox_county <- enr_2024 |>
  dplyr::filter(district_id == "0470")
} # }