get_sefire() now returns only the Burn Severity ZIP paths that exist on disk, omitting years whose download failed, so the result can be passed directly to readers (#166).
get_wui(), get_nifc(), and get_fod() now re-unzip an existing ZIP when its extracted files are missing or incomplete (for example after an interrupted unzip), without re-downloading. Previously the unzip ran only in the session that performed the download (#164).
Large-download warnings now state the actual size: get_sefire() single-file datasets (1-3 GB; #160), get_mtbs() (360 MB) and get_fod() (175 MB; #165), and get_nifc() (49 MB; #162). Each recommends a background session.
Documentation
get_sefire() docs no longer say years is “silently ignored” for single-file datasets; a warning is emitted (#168).
read_nifc() docs list .gdb as a supported archive format (#156).
get_nifc() docs state the approximate download size (#162).
Removed tracked session-artifact files and added them to .gitignore (#153).
Tests
Added regression tests for the unconditional get_sefire() “years ignored” warning (#167), the get_sefire() return value after failed downloads, and the re-unzip behaviour.
Added get_sefire() integration tests with skip_if_sefire_unreachable() (#163) and a skip_if_invalid_fod_archive() guard for FOD integration tests (#152).
testthat (>= 3.2.0) is now required for mocking.
fireR 1.1.0
Bug fixes
get_sefire() now inspects the curl::multi_download() return value and emits a warning for any failed year downloads instead of printing “Downloads complete.” unconditionally (#111).
get_sefire(), get_mtbs(), get_nifc(), get_fod(), get_wui(), and the ecoregion loaders now delete any partial or zero-byte file left on disk after a failed download, so that a subsequent call re-downloads correctly instead of treating the partial file as already-complete (#122, #125, #128, #129).
read_nifc() now checks that sf::st_layers() returns at least one layer and emits an actionable error message if the file is corrupt or empty instead of throwing “subscript out of bounds” (#118).
read_fod() now discovers the GeoPackage layer name dynamically via sf::st_layers() instead of hardcoding "Fires", matching read_nifc() and providing a clear error if the file is unreadable (#137).
get_sefire() “years ignored” warning now fires unconditionally for non-Burn-Severity datasets regardless of verbose; previously verbose = FALSE silently suppressed it (#121).
Vignette corrected: MTBS ZIP is ~360 MB, not ~100 MB (#119).
output default asymmetry between read_mtbs()/read_nifc()/read_fod() ("vect") and the ecoregion loaders ("sf") is now documented in each reader’s @param output (#120).
New functions
get_nifc(): Download the NIFC wildfire perimeters ZIP from figshare and unzip to a local directory.
read_nifc(): Read and filter NIFC wildfire perimeters from a local ZIP downloaded with get_nifc(). Supports year filtering via the integer FireYear column, and returns sf, terra::SpatVector, or data.frame.
get_fod(): Download the USFS Fire Occurrence Database (FPA-FOD) GeoPackage ZIP and unzip to a local directory.
read_fod(): Read and filter the USFS Fire Occurrence Database (FPA-FOD) from a local ZIP downloaded with get_fod(). Supports year filtering via the integer FIRE_YEAR column (dataset covers 1992–2020), and returns sf, terra::SpatVector, or data.frame.
New features
get_sefire() gains a dataset argument. In addition to the annual Burn Severity mosaics (2000–2022), it now downloads three single-file SE FireMap products covering 1994–2024: "Fire History", "Burned Area Polygons", and "Burned Area Rasters".
dry_run = FALSE added to get_mtbs(), get_sefire(), get_nifc(), get_fod(), get_wui(), and the ecoregion loaders. When TRUE, the target file path is returned without triggering a network request — useful for previewing cache locations before starting large downloads.
fireR 1.0.0
Initial stable release
get_mtbs(): Download MTBS perimeter or occurrence ZIP archives from USGS.
read_mtbs(): Read and filter MTBS fire perimeter records as sf or terra::SpatVector objects, with optional year and incident-type filtering via server-side SQL queries.
get_sefire(): Download Southeast FireMap Annual Burn Severity Mosaic ZIP archives for one or more years (2000–2022).
get_wui(): Download the USFS Wildland-Urban Interface (WUI) dataset ZIP (~4.65 GB) from the USFS public Box archive. Issues a warning that the download is large and slow, and recommends running in a background session via callr::r_bg().