Learn R Programming

mesonet (version 0.0.2)

mnet_retrieve: Retrieve Oklahoma Mesonet subdaily data

Description

Retrieves data from the Oklahoma Mesonet for a given set of station identifiers and date range

Usage

mnet_retrieve(
  stid,
  start_date = NULL,
  end_date = NULL,
  root_url = mnet_root_url(),
  site_info = NULL,
  file_cache = NULL,
  ask = !silent,
  silent = FALSE
)

Value

A data frame with Oklahoma Mesonet data. See below for a list of variables including column ID, name, unit and description:

IDNameUnitDescription
PRESStation Atmospheric PressurekPa5-minute averaged atmospheric pressure.
RAINPrecipitationmillimetersLiquid precipitation accumulation since previous 5-min record. Frozen precipitation cannot be recorded until it melts; therefore, precipitation from snow may not be recorded until several days after the snow event.
RELHRelative Humiditypercent5-minute averaged relative humidity at 1.5m.
SRADSolar Radiationwatts per square meter5-minute averaged downwelling global solar radiation.
STIDStation IDStation ID
STNMStation NumberStation Number
TA9MAir Temperature at 9mdegrees Celsius5-minute averaged air temperature at 9m
TAIRAir Temperaturedegrees Celsius5-minute averaged air temperature at 1.5m.
TB05Temperature Under Bare Soil at 5cmdegrees Celsius15-minute averaged temperature under bare soil at 5cm. This variable is only available prior to December 1, 2013.
TB10Temperature Under Bare Soil at 10cmdegrees Celsius15-minute averaged temperature under bare soil at 10cm.
TIMETimeminutes after base timeMinutes after base time (typically 0000 UTC)
TR05Soil Moisture Calibrated Delta-T at 5cmdegrees Celsius30-minute calibrated change in temperature of soil over time after a heat pulse is introduced. Used to calculate soil water potential, fractional water index, or volumetric water.
TR25Soil Moisture Calibrated Delta-T at 25cmdegrees Celsius30-minute calibrated change in temperature of soil over time after a heat pulse is introduced. Used to calculate soil water potential, fractional water index, or volumetric water.
TR60Soil Moisture Calibrated Delta-T at 60cmdegrees Celsius30-minute calibrated change in temperature of soil over time after a heat pulse is introduced. Used to calculate soil water potential, fractional water index, or volumetric water.
TR75Soil Moisture Calibrated Delta-T at 75cmdegrees Celsius30-minute calibrated change in temperature of soil over time after a heat pulse is introduced. Used to calculate soil water potential, fractional water index, or volumetric water.
TS05Temperature Under Native Vegetation at 5cmdegrees Celsius15-minute averaged temperature under native vegetation at 5cm.
TS10Temperature Under Native Vegetation at 10cmdegrees Celsius15-minute averaged temperature under native vegetation at 10cm.
TS25Temperature Under Native Vegetation at 25cmdegrees Celsius15-minute averaged temperature under native vegetation at 25cm. This variable is only available after and including December 1, 2013.
TS30Temperature Under Native Vegetation at 30cmdegrees Celsius15-minute averaged temperature under native vegetation at 30cm. This variable is only available prior to December 1, 2013.
TS45Temperature Under Native Vegetation at 45cmdegrees Celsius15-minute averaged temperature under native vegetation at 45cm.
TS60Temperature Under Native Vegetation at 60cmdegrees Celsius15-minute averaged temperature under native vegetation at 60cm. This variable is only available after and including December 1, 2013.
VW05Volumetric soil water Under Native Vegetation at 5cmcm^3^ cm^-3^5-minute averaged volumetric soil water under native vegetation at 5cm.
VW25Volumetric soil water Under Native Vegetation at 25cmcm^3^ cm^-3^5-minute averaged volumetric soil water under native vegetation at 25cm.
VW45Volumetric soil water Under Native Vegetation at 45cmcm^3^ cm^-3^5-minute averaged volumetric soil water under native vegetation at 45cm.
WDIRWind Directiondegrees5-minute averaged wind direction at 10m.
WDSDWind Direction Standard DeviationdegreesStandard deviation of wind direction during the 5-minute interval.
WMAXMaximum Wind Speedmeters per secondHighest 3-second wind speed at 10m sample.
WS2M2m Wind Speedmeters per second5-minute averaged wind speed at 2m
WSPDWind Speedmeters per second5-minute averaged wind speed at 10m.
WSSDWind Speed Standard Deviationmeters per secondStandard deviation of wind speed during the 5-minute interval.
WVECWind Vectormeters per second5-minute averaged wind velocity (speed and direction accounted for) at 10m.

Arguments

stid

a character vector of four-digit station identifiers for the Mesonet stations from which to download data

start_date

the first date for which to download data specified in Central Standard Time (i.e. "America/Costa_Rica") zone as a Date or POSIXt object or a string with the format YYYY-MM-DD, where YYYY is the four-digit year, MM is the two-digit numeric month and DD is the two-digit day of month

end_date

the final date for which to download data specified in Central Standard Time (i.e. "America/Costa_Rica") zone as a Date or POSIXt object or a string with the format YYYY-MM-DD, where YYYY is the four-digit year, MM is the two-digit numeric month and DD is the two-digit day of month

root_url

the root url from which to download MTS files (see mnet_root_url)

site_info

a data frame with site and soil information for each Oklahoma Mesonet station as returned by mnet_site_info. If NULL, mnet_site_info will be used to download this information internally

file_cache

a character string providing a path to the local Mesonet file cache. If NULL, the function will search for the local file cache and if not found will prompt the user to create one.

ask

whether or not to ask about creating a local Mesonet file cache

silent

whether to suppress output to terminal (TRUE) or allow output to terminal (FALSE)

Examples

Run this code

# \dontshow{
  mesonet_cache_dir <- mnet_test_cache(site_info = TRUE,
                                       mts_files = TRUE,
                                       rds_files = TRUE)
  previous_options <- options(.mesonet_cache = mesonet_cache_dir)
# }

mnet_retrieve(stid = "ACME",
                 start_date = "1994-01-02",
                 end_date = "1994-01-03")

# \dontshow{
  unlink(mesonet_cache_dir, recursive = TRUE)
  options(previous_options)
# }

Run the code above in your browser using DataLab