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, inequality and convergence statistics); and turns one hand-drawn choropleth into a full vocabulary of projected, area-honest maps (binned and quantile choropleths, proportional-symbol, spike, bivariate, cartogram, tile-grid, flow, small-multiple, animated, globe and interactive), and can hand its curated, ISO-reconciled tables to 'ggsql' for database-side spatial rendering. Heavy spatial dependencies stay optional, and a bundled offline snapshot lets every example, test and vignette run without the network.

Version:	2.0.0
Depends:	R (≥ 4.1.0)
Imports:	cli, countrycode, dplyr, ggplot2, memoise, rlang, tibble, tidyr, WDI
Suggests:	biscale, cartogram, classInt, covr, DBI, duckdb, gganimate, ggiraph, ggrepel, ggsql, gifski, knitr, leaflet, magick, mapproj, maps, nanoarrow, plotly, rmapshaper, rmarkdown, rnaturalearth, rnaturalearthdata, scales, sf, stringdist, testthat (≥ 3.0.0)
Published:	2026-08-25
DOI:	10.32614/CRAN.package.countryatlas
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 [issues need fixing before 2026-09-15]

Documentation:

Reference manual:	countryatlas.html , countryatlas.pdf
Vignettes:	Beyond the choropleth (source, R code) countryatlas and ggsql (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_2.0.0.tar.gz
Windows binaries:	r-devel: countryatlas_1.0.0.zip, r-release: countryatlas_1.0.0.zip, r-oldrel: countryatlas_2.0.0.zip
macOS binaries:	r-release (arm64): countryatlas_2.0.0.tgz, r-oldrel (arm64): countryatlas_2.0.0.tgz, r-release (x86_64): countryatlas_2.0.0.tgz, r-oldrel (x86_64): countryatlas_2.0.0.tgz
Old sources:	countryatlas archive

Linking:

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