Version 0.5.x is a refactoring to accommodate MazamaSpatialUtils 0.8 which is based on the sf package rather than sp. As much as possible, the suite of functions and arguments will remain the same.

Version 0.4 utilizes the MazamaTimeSeries package to provide a lot of core functionality associated with manipulation of “single time series” aka ” sts objects.

  • Added dependency on MazamaTimeSeries.
  • Updated fw13_createMeta() to be compatible with sts objects.
  • Removed fw13_createRawDataframe() and added fw13_parseData() so that the two-step process is now explicit.
  • Changed raws_ExtractMeta/Data() to raws_getMeta/Data().
  • Updated raws_filterDate() with new arguments to match sts_filterDate().
  • Rebuild example datasets with new metadata columns.
  • Removed rawsDF_~() functionality. This could be included in an add-on RAWSmetPlots package if ggplot functionality is desired.
  • Removed ggplot-based functions: timeseriesMultiplot() and windTimeseriesPlot().
  • Updated wrcc_createMeta() to be compatible with sts objects.
  • wrcc_parseData now enforces significant digits.
  • Renamed fw13 to cefa throughout the package to adhere to the convention of naming things by data provider, CEFA, rather than by format, FW13.
  • Updated vignettes and articles to use new functions.
  • Corrected time shift from “Local Standard Time” (LST) to UTC. (We had previously added UTC_offset when it needs to be subtracted from LST.)

Version 0.3.x is a release version and ready for use. Patch level updates will address bug fixes and minor requests for improvement.

  • Minor tweaks to examples.
  • Added VPD (Vapor Pressure Deficit) and FFWI (Fosberg Fire Weather Index) columns during raws_toRawsDF() creation of the rawsDF tidy dataframe.
  • Proper handling of missing data in FFWI calculation in raws_toRawsDF().
  • Minor updates to articles.
  • rawsList_toRawsDF() now returns a single tidy dataframe containing data and metadata from each station in the given list.
  • Fix issue where loading functions were returning NA when no local data was found and newDownload = FALSE.
  • Fixed newDownload logic in each loading function.
  • New utility functions for rawsDF objects such as rawsDF_isRawsDF(), rawsDF_filter() and rawsDF_filterDate().
  • Added rawsList_isRawsList()
  • Added a timezone column to the structure of a rawsDF object.
  • New rawsList_toRawsDF() function converts a list of raws objects to a list of tidy (rawsDF) dataframes.
  • Fixed conversion to metric precipitation in fw13_createTimeseriesObject().
  • Fixed bug in rawsList_removeEmpty().
  • New “RAWSmet Usage” article.
  • New “Oregon/Washington 2020 Water Deficit” article.
  • Updated “September 2020 Oregon Wildfires” article.
  • Replaced parameter forceDownload with newDownload with a default option of NA. The new behavior is to always download when newDownload = TRUE, never download when newDownload = FALSE and download if not found when newDownload = NA – the default.
  • New raws_filterDate() now returns a raws object with no data records when no valid data existin within the requested time range.
  • New raw_toRawsDF() function convertions a raws object (list with ‘meta’ and ‘data’) into a tidy dataframe for use with dplyr and ggplot2.
  • Fixed bug in wrcc_loadYear() to allow it to load data from past years.
  • All examples accessing archival WRCC data now include password = MY_PASSWORD so that users can set the MY_PASSWORD to their personal password and then run the examples.
  • Added rawsList_removeEmpty().
  • Fixed WRCC ingest so that columns with all missing are of type ‘numeric’.
  • Tweak downloading messages.
  • Data access error messages are now displayed by wrcc_loadMultiple().
  • raws_extractData(forOpenair = TRUE) now adds date, ws and wd variables based on datetime, windSpeed and windDirection.
  • Changed default wrcc metadata name created by wrcc-loadMeta() to wrcc_meta_<stateCode>.rda
  • Renamed functions with Metadata to just Meta for consistency.
  • WRCC download/parse functions now harmonizing units to guarantee metric units for all parameters.
  • Add password support to all wrcc_~() data access functions.
  • wrcc_load() was renamed to wrcc_loadYear().
  • Many examples have been updated to run with example_ data so they can be tested.
  • New windTimeseriesPlot()
  • Completely refactored wrcc_identifyMonitorType() to handle 46!! different data formats coming from WRCC.
  • Columns with all NA are dropped by timeseriesMultiplot().
  • Added example datasets example_fw13Meta.rda, example_wrccMeta.rda, example_fw13SaddleMountain.rda, example_wrccSaddleMountain.rda.
  • Changed stationID to wrccID throughout the code base.
  • Added verbose arguments to all data loading functions. Functions that create metadata default to verbose = TRUE.
  • “FW13” and “WRCC” metadata are now harmonized to always return the same set of columns.
  • Removed state names from “WRCC” metadata siteName field.
  • New addWindBarbs() function to create standard wind barbs for use with base plots.
  • Improved wrcc_createMetadata() to handle combined-state metadata pages at WRCC.
  • New timeseriesMultiplot() function plots the $data portion of raws_timeseries objects.
  • Added utility functions: raws_distinct(), raws_filter(), raws_filterDate(), raws_isEmpty(), raws_isRaws() to aid in building “recipe style” pipelines.
  • Added fw13_load() and wrcc_load() functions to create and save timeseries data in the rawsDataDir directory.
  • Added fw13_loadMeta() and wrcc_loadMeta() functions to create and save metadata in the rawsDataDir directory.
  • wrcc_leaflet() renamed to raws_leaflet().
  • fw13_createTimeseriesObject() now converts data to metric units.
  • Added “Working with openair” article.
  • Added README.md.
  • Added “Identifying Unique Locations” article.

Reading data in FW13 format from https://cefa.dri.edu/raws/

  • fw13_createMetadata()
  • fw13_createRawDataframe()
  • fw13_createTimeseriesObject()
  • fw13_downloadData()

First generally useful functionality:

  • raws_createMetdata()
  • raws_createRawDataframe()
  • raws_createTimeseriesObject()
  • raws_downloadData()
  • raws_identifyMonitorType()
  • raws_leaflet()
  • raws_parseData()
  • Initial Release