countryatlas: Join World Bank Data, Country Codes and Maps on the ISO Spine

A complete toolkit for getting country data onto honest maps. Country names rarely line up across data sources ("US", "U.S.", "United States", "United States of America" are one country, but a naive join treats them as four), so 'countryatlas' makes ISO codes the universal join key. It generalises a one-call, map-ready table that stitches together 'ggplot2' map geometry, 'WDI' World Bank indicators and the 'countrycode' Rosetta stone; exposes the join machinery for the user's own data; ships curated reference data (metadata, group memberships, an indicator catalogue, flags and currencies); adds analysis helpers (per-capita, regional roll-ups, ranking); and turns one hand-drawn choropleth into a full vocabulary of projected, area-honest maps (binned and quantile choropleths, proportional-symbol, bivariate, cartogram, tile-grid, flow, animated and interactive). Heavy spatial dependencies stay optional, and a bundled offline snapshot lets every example, test and vignette run without the network.

Version: 1.0.0
Depends: R (≥ 4.1.0)
Imports: cli, countrycode, dplyr, ggplot2, memoise, rlang, tibble, tidyr, WDI
Suggests: biscale, cartogram, classInt, covr, gganimate, geofacet, ggiraph, ggrepel, knitr, leaflet, maps, plotly, rmapshaper, rmarkdown, rnaturalearth, rnaturalearthdata, scales, sf, stringdist, testthat (≥ 3.0.0)
Published: 2026-06-24
DOI: 10.32614/CRAN.package.countryatlas (may not be active yet)
Author: Youzhi Yu [aut, cre]
Maintainer: Youzhi Yu <yuyouzhi666 at icloud.com>
BugReports: https://github.com/PursuitOfDataScience/countryatlas/issues
License: GPL (≥ 3)
URL: https://pursuitofdatascience.github.io/countryatlas/, https://github.com/PursuitOfDataScience/countryatlas
NeedsCompilation: no
Materials: README, NEWS
CRAN checks: countryatlas results

Documentation:

Reference manual: countryatlas.html , countryatlas.pdf
Vignettes: Beyond the choropleth (source, R code)
countryatlas: Joining World Data to Maps on the ISO Spine (source, R code)
Getting started (source, R code)
Joining your own data (source, R code)
Modern maps with sf & projections (source, R code)

Downloads:

Package source: countryatlas_1.0.0.tar.gz
Windows binaries: r-devel: not available, r-release: countryatlas_1.0.0.zip, r-oldrel: not available
macOS binaries: r-release (arm64): countryatlas_1.0.0.tgz, r-oldrel (arm64): countryatlas_1.0.0.tgz, r-release (x86_64): countryatlas_1.0.0.tgz, r-oldrel (x86_64): countryatlas_1.0.0.tgz

Linking:

Please use the canonical form https://CRAN.R-project.org/package=countryatlas to link to this page.