zoltr - An R client for the Zoltar data repository API
This package contains functions for working with the Zoltar forecast repository's API, including projects, models, forecasts, and truth. Read more about this package at the zoltr pkgdown site. Documentation on Zolar itself is at docs.zoltardata.com.
You can install the released version of zoltr from CRAN with:
And the development version from GitHub with:
# install.packages("devtools") devtools::install_github("reichlab/zoltr")
Note: Due to the rapid pace of zoltr development, CRAN version lags behind development. We highly suggest you install the development version to get the latest features.
For those starting out we recommend you begin with the Getting Started vignette.
Read more at the zoltr pkgdown site, but briefly you use the
new_connection() function to create a connection to Zoltar and then pass that connection along with the URL of the resource of interest (e.g., a project, model, or forecast) to this package's various functions like
library(zoltr) zoltar_connection <- new_connection() zoltar_authenticate(zoltar_connection, Sys.getenv("Z_USERNAME"), Sys.getenv("Z_PASSWORD")) zoltar_connection #> ZoltarConnection 'https://zoltardata.com' authenticated (exp=2021-03-22 13:57:11 UTC) the_projects <- projects(zoltar_connection) project_url <- the_projects[the_projects$name == "Docs Example Project", "url"] the_project_info <- project_info(zoltar_connection, project_url) names(the_project_info) #>  "id" "url" "owner" #>  "is_public" "name" "description" #>  "home_url" "logo_url" "core_data" #>  "time_interval_type" "visualization_y_label" "truth" #>  "model_owners" "models" "units" #>  "targets" "timezeros" the_project_info$name #>  "Docs Example Project"
Forecast data format
The native forecast data format supported by the Zoltar API is a
list. See docs.zoltardata.com for format details. You can find an example at vignettes/docs-predictions.json . By convention this package referred to this as
forecast_data. This package supports conversion to this format (which is used throughout the package) from the CDC's CSV file format  via the
forecast_data_from_cdc_csv_file() function. Future versions will support bidirectional conversion, as well as support for a more general CSV format.
 Details about the CDC CSV format can be found at flu_challenge_2016-17_update.docx.