amadeus 2.1.0
Download tier Refactor
- Standardized source downloaders and
download_data()around shared argument checks, URL and destination planning, download execution, and return handling. Existing non-empty files are skipped by the shared download runner, which also creates missing destination directories. - Standardized
download = FALSEpreviews as invisible lists containingurls,destfiles, andn_files. Previews include all planned files, including existing destinations. MODIS, MERRA-2, and GOES discovery can still make network requests. Thedownloadandremove_commandarguments remain deprecated with warnings. - Standardized download summaries as invisible lists containing
success,failed,skipped,failed_urls, andfailed_files. Both failure vectors arecharacter(0)when no downloads fail, including when all files are skipped. Counts describe file downloads, not extracted archive members. - Aligned
hash = TRUEreturns with each source’s output directory, usingdata_files/for extracted archives. Hashes are visible character scalars and include existing files recursively. Preview returns take precedence over hashing. - Consolidated date and year validation. Downloaders using
sequence_years()accept one year, two endpoints, or a longer vector and request every year between the smallest and largest values. Date ranges accept endpoints in either order. Added configurable bounds and documented the implemented source-specific limits for HMS, NARR, NLCD, and CropScape; requests outside those limits fail rather than being truncated. - Removed first-URL preflight probes and their warnings. File-transfer failures are handled by the shared download runner;
check_url_status()remains available for other uses. - Updated
download_unzip()to accept multiple archives with either one shared extraction directory or one directory per archive. Source downloaders use the common helper for batch extraction, including multi-year NLCD requests. Requested archive cleanup runs after the extraction loop. - Changed the default CropScape source to GMU and updated the USDA download URL. Archives are stored in
zip_files/, with separate extraction folders for each archive underdata_files/. Addedremove_zipsupport. - Added
download_eddi(),download_spei(), anddownload_usdm().download_drought()delegates to these functions, anddownload_data()routes their dataset aliases directly. SPEI now uses an explicitversionselection ("2.11","2.10", or"legacy", defaulting to"2.11") instead of automatically falling back between versions. - Added CMR pagination to MODIS discovery so requests can retrieve more than 2000 granules. Removed the 31-day warning; existing product-specific cross-year restrictions remain. Incomplete or inconsistent paginated responses raise discovery errors.
- Moved MERRA-2 product mappings to a package data file and separated listing discovery from downloading. MERRA-2 and GOES listing helpers use
xml2; GOES listing failures now stop discovery instead of warning and continuing. - Expanded NEI inventory selections to 2008, 2011, 2014, 2017, 2020, and 2023. Mixed supported and unsupported selections warn and retain supported years; selections with none supported stop. Named year lookups keep URLs and filenames aligned for reversed or repeated selections. NEI years remain discrete selections, and
process_nei()still supports only 2017 and 2020. - Reorganized R files into
api-,source-, andutils-groups, consolidated download helpers, and made internal helper calls explicitly qualified. Existing helper exports are retained. Updated download documentation and test mocks for the shared workflow and return values.
amadeus 2.0.3
- Fixed
download_narr()base URL to drop the “Datasets” directory.
amadeus 2.0.2
Added GRIDMET EDDI integration for all eight accumulation periods, with
eddidefaulting toeddi30d.Added native 4-km GRIDMET SPEI downloads and extraction for eight accumulation periods, retaining five-day observation dates;
speidefaults tospei30d.Fixed process_gridmet() to use valid native NetCDF time metadata from terra::time() when available and fall back to layer-name parsing when needed
Fixed download_gridmet() to handle cases where all requested files already exist locally without calling download_run_method() with an empty URL list
amadeus 2.0.0
CRAN release: 2026-05-21
Major updates to code base - breaking changes have been minmized but please report if 1.3.x versions are not working as expected
- Refactored code base to improve maintainability and utilize modern R API designs and best practices
- The only breaking change that should affect previous version users is the
process_tri()andcalculate_tri()series.
Spatial and Temporal summarization with .by and .by_time parameters
- Added
.byand.by_timeparameters to allcalculate_*()functions for consistent spatial and temporal summarization options across all datasets - The default behavior of
calculate_*()functions remains unchanged - i.e., no summarization, returning extracted or summarized values at the temporal resolution of the data - but users can now specify.byfor spatial grouping (e.g., by HUC, county, state) and.by_timefor temporal grouping (e.g., by year, month) to obtain summarized covariate values directly from the calculation step
‘frac’ option for categorical variable covariate calculation
-
hms,koppen, andecoregiondatasets now have optional fraction covariate calculation that returns the fraction of each category in the radius buffer.
drop options for categorical variable covariate calculation
-
hms,koppen, andecoregiondatasets now have optionaldropparameter that will drop or exclude categories that don’t have any coverage in the radius buffer for a given point, which can help reduce the number of columns returned when many categories are possible but only a few are present in the area around the point.
Detailed vignettes for each dataset including available variables, spatial and temporal resolution, and example use cases
- workflow vignette for each dataset with detailed information on available variables, spatial and temporal resolution, and example use cases for each dataset
nhdplusTools use
- Moved nhdplusTools from Imports to Suggests and added
requireNamespace("nhdplusTools")checks in all functions that use it
Additional MODIS products
- Added support for additional MODIS products with a focus on the burned area and active fire products
Finalize data API that were previously in development
- Added or completed the functonality for PRISM, EDGAR, CropScape, and HUC datasets
Use of GitHub Copilot for code generation and refactoring
- Used GitHub Copilot for help with code generation and refactoring across the code base, including function development, documentation, and unit tests; all generated code was reviewed and edited by the development team to ensure accuracy and consistency with package standards
Drought Index Support
- Added
download_drought(),process_drought(), andcalculate_drought()supporting three drought datasets:- SPEI (Standardized Precipitation-Evapotranspiration Index): multi-year netCDF files by accumulation timescale from https://spei.csic.es
-
EDDI (Evaporative Demand Drought Index): weekly files by accumulation timescale from NOAA PSL (https://downloads.psl.noaa.gov/Projects/EDDI/CONUS_archive/data/); legacy netCDF files from the
CONUS_Archivepath are also supported - USDM (U.S. Drought Monitor): weekly polygon shapefiles from https://droughtmonitor.unl.edu
- All three datasets are accessible via the top-level wrappers:
download_data(),process_covariates(), andcalculate_covariates()using aliases"drought","spei","eddi", or"usdm"fordataset_name/covariate. -
process_drought()returns aSpatRaster(SPEI/EDDI) orSpatVectorpolygons (USDM), both with CRSEPSG:4326. -
calculate_drought()supports.by/.by_timepost-extraction summarization consistent with all othercalculate_*()functions.
Migrate from wget/curl to httr2
- Completed migration of all
download_*functions fromhttr/wget/curlcommand-line calls tohttr2for all network requests - Deprecated
downloadparameter (use defaultdownload = TRUE) andremove_commandparameter across all download functions; both now emit informative warnings and are ignored - Added
hashparameter to alldownload_*functions for optional MD5 file integrity verification viadownload_hash()(using systemmd5sum) - Added
unzipandremove_zipparameters todownload_prism()for post-download archive handling - Added
download_run_method()internal helper for unified httr2-based file retrieval with progress reporting, retry logic, and rate limiting - Improved
check_url_status()for general-purpose URL validation - Expanded unit test coverage with mock-based tests for all download functions covering deprecation warnings, hash paths, and file-exists branches
- Added full variable reference to
download_narr()documentation, listing all 88 available NARR variable abbreviations with descriptions grouped by category (monolevel, pressure level, subsurface); resolves #194 - Added
download_narr()tests covering every variable abbreviation across all three variable categories - Fixed
download_data()dispatch to include"edgar"sodownload_edgar()is reachable via the wrapper function
amadeus 1.3.2
- Fixed deprecated file paths for NLCD, MODIS, and Ecoregions datasets
- Removed the certificate verification from ecoregion download which is not needed anymore
- For NASA datasets MODIS, VIIRS, and Geos-CF, added additional tags in the wget scripts to prevent API throttling
- httr upgraded to httr2
- Modified internal URL status check function for general use
- Added the news function to display the NEWS.md content within R pkgdown site
- Improved the reporting in the GitHub Actions workflows
amadeus 1.2
-
futureandfuture.applydependencies were removed-
nthreadsargument is removed fromcalculate_modis_par()andcalculate_nlcd()
-
-
calculate_modis_par()is renamed tocalculate_modis()