rnoaa (version 0.6.0)

meteo_coverage: Determine the "coverage" for a station data frame

Description

Call this function after pulling down observations for a set of stations to retrieve the "coverage" (i.e. how complete each field is). If either or both obs_start_date or obs_end_date are specified, the coverage test will be limited to that date range.

Usage

meteo_coverage(meteo_df, obs_start_date = NULL, obs_end_date = NULL, verbose = FALSE)

Arguments

meteo_df

a meteo data.frame

obs_start_date

specify either or both (obs_start_date, obs_end_date) to constrain coverate tests. These should be Date objects.

obs_end_date

specify either or both (obs_start_date, obs_end_date) to constrain coverate tests. These should be Date objects.

verbose

if TRUE will display the coverage summary along with returning the coverage data.frame

Value

a data.frame with the coverage for each station, minimally containing:

$ id         (chr)
$ start_date (time)
$ end_date   (time)
$ total_obs  (int)

with additional fields (and their coverage percent) depending on which weather variables were queried and available for the weather station.

Details

There is an autoplot method for the output of this function.

Examples

## Not run: 
# 
# monitors <- c("ASN00095063", "ASN00024025", "ASN00040112", "ASN00041023",
#              "ASN00009998", "ASN00066078", "ASN00003069", "ASN00090162",
#              "ASN00040126", "ASN00058161")
# obs <- meteo_pull_monitors(monitors)
# obs_covr <- meteo_coverage(obs)
# 
# library("ggplot2")
# autoplot(obs_covr)
# 
# ## End(Not run)