Skip to contents

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 = FALSE previews as invisible lists containing urls, destfiles, and n_files. Previews include all planned files, including existing destinations. MODIS, MERRA-2, and GOES discovery can still make network requests. The download and remove_command arguments remain deprecated with warnings.
  • Standardized download summaries as invisible lists containing success, failed, skipped, failed_urls, and failed_files. Both failure vectors are character(0) when no downloads fail, including when all files are skipped. Counts describe file downloads, not extracted archive members.
  • Aligned hash = TRUE returns with each source’s output directory, using data_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 under data_files/. Added remove_zip support.
  • Added download_eddi(), download_spei(), and download_usdm(). download_drought() delegates to these functions, and download_data() routes their dataset aliases directly. SPEI now uses an explicit version selection ("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-, and utils- 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

amadeus 2.0.2

  • Added GRIDMET EDDI integration for all eight accumulation periods, with eddi defaulting to eddi30d.

  • Added native 4-km GRIDMET SPEI downloads and extraction for eight accumulation periods, retaining five-day observation dates; spei defaults to spei30d.

  • 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() and calculate_tri() series.

Spatial and Temporal summarization with .by and .by_time parameters

  • Added .by and .by_time parameters to all calculate_*() 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 .by for spatial grouping (e.g., by HUC, county, state) and .by_time for 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, and ecoregion datasets 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, and ecoregion datasets now have optional drop parameter 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

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

Migrate from wget/curl to httr2

  • Completed migration of all download_* functions from httr/wget/curl command-line calls to httr2 for all network requests
  • Deprecated download parameter (use default download = TRUE) and remove_command parameter across all download functions; both now emit informative warnings and are ignored
  • Added hash parameter to all download_* functions for optional MD5 file integrity verification via download_hash() (using system md5sum)
  • Added unzip and remove_zip parameters to download_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" so download_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

  • future and future.apply dependencies were removed
  • calculate_modis_par() is renamed to calculate_modis()

amadeus 1.1

  • calc_*() functions are renamed to calculate_*() per naming convention of other function family in the package

amadeus 1.0

  • First CRAN release (v.1.0.0)