Skip to contents

Changelog

Source: NEWS.md

preMetabolizer 0.0.0.9000

  • closest_noaa_stations() now queries the NCEI Search API with a bounding box instead of downloading the full MSHR station archive; the state and clean arguments have been removed (no issue).

  • download_ghcnh() and read_ghcnh() have been replaced by get_ghcnh(), which downloads GHCNh files and returns a parsed tibble directly (no issue).

  • get_ghcnh() now uses the GHCNh v1.1.0 archive with per-year PSV files; it can retrieve data for multiple stations in parallel, accepts a date range instead of individual years, and returns column names in snake_case (no issue).

  • get_noaa_stations() now queries the NCEI Search API for GHCND stations instead of parsing the MSHR fixed-width archive; it accepts bbox, start_date, end_date, data_types, and text arguments; the state, clean, and debug arguments have been removed (no issue).

  • ncei_bbox() computes a bounding box from a centre latitude, longitude, and radius in kilometres (no issue).

  • ncei_data() can retrieve data from any NCEI dataset (e.g., "daily-summaries", "global-hourly") via the NCEI Access Data Service API (no issue).

  • ncei_datasets() retrieves metadata about an NCEI dataset from the Support Service API (no issue).

  • ncei_stations() searches for stations across any NCEI dataset via the NCEI Search Service API, with optional bounding box, date range, and data type filters (no issue).

  • Added french_creek dataset: 5-minute dissolved oxygen and water temperature records from French Creek, Laramie, WY (Aug–Sep 2012), courtesy of Bob Hall. Source: Hall et al. (2016), .

  • Added “Preparing French Creek Data for Stream Metabolism Modeling” vignette demonstrating a complete preMetabolizer workflow: solar time conversion, modeled PAR, elevation-corrected barometric pressure, O2 saturation, and streamMetabolizer input assembly.

  • Data-download helpers now throttle HTTP requests and use bounded parallel request execution to avoid sending too many simultaneous requests to remote services (no issue).

  • Mesonet helpers now return snake_case table columns and use consistent station and network identifiers such as station_id, station_name, network, and network_name across Kansas Mesonet, TexMesonet, and IEM results (no issue).

  • Messages, warnings, and errors now consistently use cli formatting across the package (no issue).

  • calc_O2sat() now uses the Benson and Krause umol/kg coefficients from Garcia and Gordon (1992), converts to mg/L with salinity-aware density, and applies the corrected vapor-pressure term for non-standard pressure (no issue).

  • calc_vapor_press() with method = "MIMSY" now returns physically correct values. The Antoine equation constant B was incorrectly set to 140.264 (should be 1435.264), causing vapor pressures that were orders of magnitude too large.

  • calc_water_density() no longer accepts a .drop_units argument; it always returns a plain numeric vector (no issue).

  • calc_water_height() now gives a clear error when type = "unvented" is used without providing atmo_kPa, rather than silently returning NA.

  • closest_noaa_stations() now uses latitude and longitude arguments. The old lat, long, and lon aliases are deprecated (no issue).

  • convert_flow() now requires an explicit from argument specifying the input unit; it always returns a plain numeric vector instead of a units object (no issue).

  • convert_PAR_to_SW() and convert_SW_to_PAR() are no longer re-exported from preMetabolizer. Call streamMetabolizer::convert_PAR_to_SW() and streamMetabolizer::convert_SW_to_PAR() directly (no issue).

  • convert_pressure() now requires an explicit from argument; it always returns a plain numeric vector. Unit-bearing objects are no longer accepted as input. convert_pressure() is now the sole public pressure conversion helper; convert_pressure_to_atm() has been removed (no issue).

  • correct_bp() no longer accepts a drop_units argument; it always returns a plain numeric vector. Elevation inputs must be plain numeric (meters) (no issue).

  • download_ghcnh() now validates inputs more clearly, treats existing local files as skipped downloads, and reports skipped files in its summary (no issue).

  • even_timesteps() no longer errors on single-column data frames due to drop = TRUE subsetting.

  • get_nasa_data() now accepts time-series data directly, infers per-site download date ranges from the data, uses either single-site latitude and longitude arguments or per-site latitude, longitude, and elev_m columns, interpolates NASA values to the input timestamps, returns light.obs by converting ALLSKY_SFC_SW_DWN with streamMetabolizer::convert_SW_to_PAR(), and runs quietly by default. The old lat and lon aliases are deprecated (no issue).

  • get_noaa_stations() now filters cached raw station metadata by state, validates options more clearly, and uses cached station metadata when remote modification times are unavailable (no issue).

  • get_usgs_elev() can now retrieve elevation values from the USGS Elevation Point Query Service for one or more coordinate pairs (no issue).

  • has_units() has been removed. The units package is no longer a dependency (no issue).

  • iem_current(), iem_daily(), iem_networks(), iem_obhistory(), iem_station(), and iem_stations() can now retrieve Iowa Environmental Mesonet network metadata, station metadata, current observations, one-day observation histories, and daily summaries (no issue).

  • ks_meso_fw13() can now retrieve Kansas Mesonet fire weather data in FW13 format for one station and date range (no issue).

  • ks_meso_most_recent() can now retrieve the most recently ingested Kansas Mesonet timestamp for each station at a requested interval (no issue).

  • ks_meso_timeseries() can now retrieve Kansas Mesonet station or network observations directly without writing to or reading from a local cache. The old get_ks_meso() and read_ks_meso() cache-oriented helpers have been removed before production release (no issue).

  • rcpp_calc_exceedance_prob() now provides a C++ implementation of flow exceedance probability calculations (no issue).

  • read_ghcnh() is now exported, validates file inputs, can suppress progress messages with quiet = TRUE, and handles files that lack Station_name or Station_ID columns (no issue).

  • tex_meso_stations(), tex_meso_current(), and tex_meso_timeseries() can now retrieve Texas Water Development Board station metadata, current observations, and recent station time-series data from TexMesonet (no issue).