Skip to contents

PAHO dengue data (North and South America)

Source: R/endpoints.R
pub_paho_dengue.Rd

[Deprecated]

This endpoint was previously deprecated and remains available for historical reference. The underlying data source is no longer updated and no new data is being ingested. For more details, refer to the "Endpoints kept for historical reference" section of vignette("migration-guide"), and visit the V5 signals documentation.

API docs: https://cmu-delphi.github.io/delphi-epidata/api/paho_dengue.html

Usage

pub_paho_dengue(
  regions,
  epiweeks = "*",
  ...,
  issues = NULL,
  lag = NULL,
  fetch_args = fetch_args_list()
)

Arguments

regions

character. List of regions to fetch. See Americas' geographic codes # nolint for details.

epiweeks

timeset. Epiweeks to fetch. Supports epirange() and defaults to all ("*") dates. Format as epirange(startweek, endweek), where startweek and endweek are of the form YYYYWW (string or numeric).

...

not used for values, forces later arguments to bind by name

issues

timeset. Optionally, the issue(s) of the data to fetch. See the "Data Versioning" section for details.

lag

integer. Optionally, the lag of the issues to fetch. See the "Data Versioning" section for details.

fetch_args

fetch_args_list(). Additional arguments to pass to fetch(). See fetch_args_list() for details.

Value

tibble::tibble

Data Versioning

Several endpoints support retrieving historical versions of the data. The following parameters control this and are mutually exclusive (only one can be provided at a time).

  • as_of: (Date) Retrieve the data as it was on this date.

  • issues: timeset Retrieve data from a specific issue date or range of dates.

  • lag: (integer) Retrieve data with a specific lag from its issue date.

If none of these is specified, the most recent version of the data is returned.

See vignette("versioned-data") for details and more ways to specify versioned data.

See also

For example queries showing how to discover signals and build calls, see vignette("signal-discovery", package = "epidatr").

Examples


pub_paho_dengue(regions = "ca", epiweeks = epirange(201401, 201501))
#> `pub_paho_dengue()` covers a data source that is no longer updated.
#> ℹ Historical data remains available, but no new data is being ingested.
#> ℹ See the "Endpoints kept for historical reference" section of
#>   `vignette("migration-guide")` (or
#>   <https://cmu-delphi.github.io/epidatr/articles/migration-guide.html#endpoints-kept-for-historical-reference>)
#>   for details.
#> This message is displayed once per session.
#> # A tibble: 54 × 11
#>    release_date region serotype issue      epiweek      lag total_pop num_dengue
#>    <date>       <chr>  <chr>    <date>     <date>     <dbl>     <dbl>      <dbl>
#>  1 2020-08-07   CA     "  "     2020-08-02 2013-12-29   344         0          0
#>  2 2020-08-07   CA     "  "     2020-08-02 2014-01-05   343         0          0
#>  3 2020-08-07   CA     "  "     2020-08-02 2014-01-12   342         0          0
#>  4 2020-08-07   CA     "  "     2020-08-02 2014-01-19   341         0          0
#>  5 2020-08-07   CA     "  "     2020-08-02 2014-01-26   340         0          0
#>  6 2020-08-07   CA     "  "     2020-08-02 2014-02-02   339         0          0
#>  7 2020-08-07   CA     "  "     2020-08-02 2014-02-09   338         0          0
#>  8 2020-08-07   CA     "  "     2020-08-02 2014-02-16   337         0          0
#>  9 2020-08-07   CA     "  "     2020-08-02 2014-02-23   336         0          0
#> 10 2020-08-07   CA     "  "     2020-08-02 2014-03-02   335         0          0
#> # ℹ 44 more rows
#> # ℹ 3 more variables: num_severe <dbl>, num_deaths <dbl>, incidence_rate <dbl>