Fetch NJ SPED placement data for multiple years
Source:R/sped_placement.R
fetch_sped_placement_multi.RdConvenience wrapper that calls fetch_sped_placement for each
year and binds the results. Strict mode is the default; partial results must
be requested explicitly and retain per-year source status.
Usage
fetch_sped_placement_multi(
end_years,
age_group = "5-21",
level = "district",
tidy = TRUE,
with_status = FALSE,
allow_partial = FALSE
)Arguments
- end_years
integer vector of school years
- age_group
one of
"5-21"or"3-5"- level
one of
"district"or"state"- tidy
logical; passed through to
fetch_sped_placement()- with_status
logical; passed through to
fetch_sped_placement()- allow_partial
logical; if
FALSE(default), any failed or unsupported year aborts the request. IfTRUE, successful years are returned with status available fromget_source_results().
Details
Every (end_year, age_group, level) combination across 2020-2025
returns data, so fetch_sped_placement_multi(2020:2025) produces a
single bound tibble covering the whole range. A per-year failure aborts in
strict mode; partial results require allow_partial = TRUE.
Examples
if (FALSE) { # \dontrun{
# Pull every supported year (district 5-21) into one tibble.
placement_all <- fetch_sped_placement_multi(2020:2025)
# Full state-level coverage across 2020-2025 (combines structured
# downloads with transcribed-PDF slices for state-level 2020-2022).
fetch_sped_placement_multi(2020:2025, level = "state")
} # }