povcalnetR"

In povcalnetR: Client for the 'Povcalnet' API

NOT_CRAN <- identical(tolower(Sys.getenv("NOT_CRAN")), "true")
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  purl = NOT_CRAN
)

library(povcalnetR)

The povcalnetR package allows to easily query the PovcalNet API from R.

Here are a few examples to get you started:

Using default options

By default, the povcalnet function return all available

• countries
• coverages (national, urban, rural)
• for all available survey years
• at the 1.9 USD poverty line

povcalnet()

Basic options

Filter by country

# Specify ONE country
povcalnet(country = "ALB")

# Specify MULTIPLE countries
povcalnet(country = c("ALB", "CHN"))

Filter by year

By default, povcalnet will only return data if a survey is available for the requested country and the requested year

# Survey year NOT available
povcalnet(country = "ALB", year = 2012)

# Survey year NOT available - Empty response
povcalnet(country = "ALB", year = 2018)

Modify the poverty line

povcalnet(country = "ALB", povline = 3.2)

Other features

Get estimates when survey year is not available

The fill_gaps argument will trigger the interpolation / extrapolation of poverty estimates when survey year is not available

# fill_gaps = FALSE (default)
povcalnet(country = "HTI")

# fill_gaps = TRUE
povcalnet(country = "HTI", fill_gaps = TRUE)

Compute custom aggregates

The povcalnet function can also be used to compute aggregate welfare statistics of custom group of countries

# World aggregate
povcalnet(country = "all", aggregate = TRUE)

# Custom aggregate
povcalnet(country = c("CHL", "ARG", "BOL"), aggregate = TRUE)

povcalnetR documentation built on July 8, 2020, 6:48 p.m.