get_forecaster_predictions: Get predictions from a forecaster on the COVID Hub

Description Usage Arguments Value See Also

View source: R/get_covidhub_predictions.R

Description

Simply converts the predictions of forecasters submitting to the COVID Hub to the format of a predictions card, so it can be easily evaluated and compared.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
get_forecaster_predictions(
  covidhub_forecaster_name,
  forecast_dates = NULL,
  geo_values = "*",
  forecast_type = c("point", "quantile"),
  ahead = 1:4,
  incidence_period = c("epiweek", "day"),
  signal = c("confirmed_incidence_num", "deaths_incidence_num",
    "deaths_cumulative_num")
)

Arguments

covidhub_forecaster_name

String indicating of the forecaster (matching what it is called on the COVID Hub).

forecast_dates

Vector of Date objects (or strings of the form "YYYY-MM-DD") indicating dates on which forecasts will be made. If NULL, the default, then all currently available forecast dates from the given forecaster in the COVID Hub will be used.

geo_values

vector of character strings containing FIPS codes of counties, or lower case state abbreviations (or "us" for national). The default "*" fetches all available locations

forecast_type

"quantile", "point" or both (the default)

ahead

number of periods ahead for which the forecast is required. NULL will fetch all available aheads

incidence_period

one of "epiweek" or "day". NULL will attempt to return both

signal

this function supports only "confirmed_incidence_num", "deaths_incidence_num", and/or "deaths_cumulative_num" (those currently forecast by the COVIDhub-ensemble). For other types, use one of the alternatives mentioned above

Value

Long data frame of forecasts with a class of predictions_cards. The first 4 columns are the same as those returned by the forecaster. The remainder specify the prediction task, 10 columns in total: ahead, geo_value, quantile, value, forecaster, forecast_date, data_source, signal, target_end_date, and incidence_period. Here data_source and signal correspond to the response variable only.

Predictions card. For more flexible processing of COVID Hub data, try using zoltr

See Also

get_predictions()

get_zoltar_predictions()


dshemetov/evalcast-mirror documentation built on Feb. 4, 2022, 8:52 a.m.