{"Package":"idbr","Type":"Package","Title":"R Interface to the US Census Bureau International Data Base API","Version":"1.2","Date":"2024-03-19","Authors@R":"c(person(given=\"Kyle\", family=\"Walker\", email=\"kyle.walker@tcu.edu\", role=c(\"aut\", \"cre\")))","Description":"Use R to make requests to the US Census Bureau's International Data Base API.\nResults are returned as R data frames. For more information about the IDB API, visit\n.","License":"MIT + file LICENSE","LazyData":"TRUE","Encoding":"UTF-8","Depends":"R (>= 3.0.0)","Suggests":"tidyr, plotly","Imports":"jsonlite, dplyr, httr, countrycode, purrr, rnaturalearthdata,\nsf, stringr","RoxygenNote":"7.2.3","NeedsCompilation":"no","Packaged":"2024-03-19 17:57:56 UTC; kylewalker","Author":"Kyle Walker [aut, cre]","Maintainer":"Kyle Walker ","Repository":"CRAN","Date/Publication":"2024-03-19 18:10:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/idbr_1.2.tar.gz","jsonAuthors":[{"name":"Kyle Walker","email":"kyle.walker@tcu.edu","maintainer":true}],"readme":"# idbr\nAn R interface to the US Census Bureau International Data Base API\n\n

\n\n\n [![R build status](https://github.com/walkerke/idbr/workflows/R-CMD-check/badge.svg)](https://github.com/walkerke/idbr/actions)![](http://www.r-pkg.org/badges/version/idbr) ![](http://cranlogs.r-pkg.org/badges/idbr)\n \n\n__Update: version 1.0 introduces a re-written and re-factored package API. Functions from earlier versions of the package are deprecated and not recommended for use.__\n\nThis R package enables users to fetch international demographic indicators from the US Census Bureau's International Data Base API and return R data frames. Total population data are available from 1950-2100 (projected); age-group subsets and other demographic indicators are available for varying periods by country. \n\nInstall from CRAN with: \n\n```r\ninstall.packages('idbr')\n```\n\nOr get the development version from GitHub: \n\n```r\nlibrary(devtools)\ninstall_github('walkerke/idbr')\n```\n\n## Basic usage: \n\nTo get started, load __idbr__ and set your Census API key with the `idb_api_key()` function. An API key can be obtained from the US Census Bureau at . tidycensus users can use their existing API keys which idbr will pick up if already installed.\n\n```r\nlibrary(idbr)\n\nidb_api_key('Your API key goes here')\n```\n\nThe core function used in idbr is `get_idb()`. This function grants access to two core APIs. The first is the single-year-of-age API, which returns population counts by single-year age bands, subsetted optionally by sex and age range. This dataset is well-suited for analyses and visualizations of the age composition of countries, such as population pyramids: \n\n```r\nlibrary(idbr)\nlibrary(tidyverse)\n\nchina_data <- get_idb(\n country = \"China\",\n year = 2021,\n age = 0:100,\n sex = c(\"male\", \"female\")\n) \n\nchina_data %>%\n mutate(pop = ifelse(sex == \"Male\", pop * -1, pop)) %>%\n ggplot(aes(x = pop, y = as.factor(age), fill = sex)) + \n geom_col(width = 1) + \n theme_minimal(base_size = 15) + \n scale_x_continuous(labels = function(x) paste0(abs(x / 1000000), \"m\")) + \n scale_y_discrete(breaks = scales::pretty_breaks(n = 10)) + \n scale_fill_manual(values = c(\"red\", \"gold\")) + \n labs(title = \"Population structure of China in 2021\",\n x = \"Population\",\n y = \"Age\",\n fill = \"\")\n\n\n```\n\n

\n\n`get_idb()` also grants access to the five-year-age-band dataset, which includes a wide range of fertility, mortality, and migration indicators along with overall population counts. In turn, it can be used to inform analyses of how demographic indicators vary by country, among many other use cases. The argument `geometry = TRUE` can be used to return country boundaries as simple features along with your data which is helpful for mapping global and regional trends. \n\n```r\nlibrary(idbr)\nlibrary(tidyverse)\n\nlex <- get_idb(\n country = \"all\",\n year = 2021,\n variables = c(\"name\", \"e0\"),\n geometry = TRUE\n)\n\nggplot(lex, aes(fill = e0)) + \n theme_bw() + \n geom_sf() + \n coord_sf(crs = 'ESRI:54030') + \n scale_fill_viridis_c() + \n labs(fill = \"Life expectancy \\nat birth (2021)\")\n```\n\n

\n\n","jobInfo":{"package":"idbr","version":"1.2","parsingStatus":"success","parserVersion":2,"parsedAt":"2024-03-19T19:30:07+0000"}}

Description

Usage

Arguments