cefa_loadMultiple: Load multiple FW13 RAWS timeseries objects from a local...

View source: R/cefa_loadMultiple.R

cefa_loadMultipleR Documentation

Load multiple FW13 RAWS timeseries objects from a local directory

Description

Loads FW13 station metadata and data from the rawsDataDir. If the data is not in this directory, this will download and save the data.

Usage

cefa_loadMultiple(
  nwsIDs = NULL,
  meta = NULL,
  newDownload = NA,
  baseUrl = "https://cefa.dri.edu/raws/fw13/",
  verbose = TRUE
)

Arguments

nwsIDs

Vector of NWS RAWS station identifiers.

meta

Tibble of FW13 station metadata.

newDownload

Logical flag stating whether or not to download and override existing data.

baseUrl

Base URL for data queries.

verbose

Logical flag controlling detailed progress statements.

Value

List of timeseries objects each containing 'meta' and 'data'.

Note

The 'newDownload' parameter has three possible settings:

  • NA – Download data if it is not found in rawsDataDir

  • TRUE – Always download data, overwriting existing data in rawsDataDir. This is useful for updating data files with more recent data.

  • FALSE – Never download data. This is useful when working with wrcc_loadMultiple and archival data to avoid continually requesting data for stations which have no data over a particular time period.

References

Program for Climate, Ecosystem and Fire Applications

See Also

cefa_createRawsObject

cefa_load

setRawsDataDir

Examples

## Not run: 
# Fail gracefully if any resources are not available
try({

library(MazamaSpatialUtils)
setSpatialDataDir("~/Data/Spatial")
loadSpatialData("NaturalEarthAdm1")

library(RAWSmet)
setRawsDataDir("~/Data/RAWS")

stationMeta <- cefa_loadMeta()

nwsIDs <- c("021503", "500726", "020401")
stationData <- cefa_loadMultiple(nwsIDs = nwsIDs, meta = stationMeta)

dplyr::glimpse(stationData, width = 75)

}, silent = FALSE)

## End(Not run)


MazamaScience/RAWSmet documentation built on May 6, 2023, 6:57 a.m.