README.md

In expersso/hdr: Interface to the UNDP Human Development Report API

hdr package

The UNDP has shut down their API, so this package is now deprecated.

The hdr package provides a complete interface to the United Nations Development Programme Human Development Report API. This data source includes a large amount of human development data, including all the series used to compute the Human Development Index (HDI), as well as the HDI itself.

To get the package:

# From CRAN
install.packages("hdr")

# Development version
library(devtools)
install_github("expersso/hdr")

Usage example

library(hdr)

# Get a data frame with id and indicator names
head(hdr_indicators)

## Source: local data frame [6 x 2]
## 
##       id                                           indicator
##    (chr)                                               (chr)
## 1  36806      Adolescent birth rate (women aged 15-19 years)
## 2 101406                     Adult literacy rate, both sexes
## 3  27706                 Carbon dioxide emissions per capita
## 4  98106                    Change in forest area, 1990/2011
## 5 105906 Combined gross enrollment in education (both sexes)
## 6 103706                                     Education index

# Get the Human Development Index for Germany in 2013
hdi <- get_data(indicator = 137506, country = "DEU", year = 2013)
head(hdi)

## Source: local data frame [1 x 6]
## 
##       id                                 indicator iso3c country  year
##    (chr)                                     (chr) (chr)   (chr) (int)
## 1 137506 HDI: Human development index (HDIg) value   DEU Germany  2013
## Variables not shown: value (dbl)

# Leave a dimension as NULL (default) to get all values for that dimension
# e.g. all countries and all year for a specific indicator:
df <- get_data(103606)
head(df)

## Source: local data frame [6 x 6]
## 
##       id         indicator iso3c     country  year value
##    (chr)             (chr) (chr)       (chr) (int) (dbl)
## 1 103606 HDI: Income index   AFG Afghanistan  1980 0.489
## 2 103606 HDI: Income index   AFG Afghanistan  1985 0.513
## 3 103606 HDI: Income index   AFG Afghanistan  1990 0.486
## 4 103606 HDI: Income index   AFG Afghanistan  1995 0.327
## 5 103606 HDI: Income index   AFG Afghanistan  2000 0.328
## 6 103606 HDI: Income index   AFG Afghanistan  2005 0.366

# Get the adolescent birth rate for all years and all countries
br <- get_data(c(24806, 36806), year = 2010:2013)

library(dplyr)
library(tidyr)

br <- br %>% 
  group_by(id, iso3c) %>% 
  summarise(mean_val = mean(value, na.rm = TRUE)) %>% 
  spread(id, mean_val) %>% 
  .[complete.cases(.), ] %>% 
  setNames(c("iso3c", "fem_ed", "birth_rate"))

library(ggplot2)

ggplot(br, aes(x = fem_ed, y = birth_rate, label = iso3c)) +
  geom_text(size = 3, alpha = 0.75) +
  geom_smooth() +
  theme_light(8) +
  labs(y = "\nAdolescent birth rate (women aged 15-19 years)",
       x = "Population with at least secondary education, female/male ratio\n",
       title = "Relationship between female education and adolescent birth rate (2010-2013 means)")

expersso/hdr documentation built on May 16, 2019, 9:44 a.m.