Skip to contents

Downloads and processes directory data from the Michigan CEPI Educational Entity Master (EEM). Includes public school districts, schools, and charter (PSA) schools with contact information, addresses, grade ranges, and administrator names.

Usage

fetch_directory(end_year = NULL, tidy = TRUE, use_cache = TRUE)

Arguments

end_year

Not used for directory data (EEM provides current snapshot only). Included for API consistency with other fetch functions.

tidy

If TRUE (default), returns data in a standardized schema with consistent column names. If FALSE, returns the raw EEM column names.

use_cache

If TRUE (default), uses locally cached data when available. Set to FALSE to force re-download from CEPI.

Value

Data frame with directory data. Tidy format includes standardized columns: state_district_id, state_school_id, district_name, school_name, entity_type, address, city, state, zip, phone, grades_served, county_name, superintendent_name, superintendent_email, principal_name, principal_email, website.

Examples

if (FALSE) { # \dontrun{
# Get current directory data
dir_data <- fetch_directory()

# Get raw format (original EEM column names)
dir_raw <- fetch_directory(tidy = FALSE)

# Force fresh download (ignore cache)
dir_fresh <- fetch_directory(use_cache = FALSE)

# Filter to Detroit Public Schools
detroit <- dir_data |>
  dplyr::filter(state_district_id == "82015")
} # }