Package: countryatlas 1.0.0

Youzhi Yu

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.

Authors:Youzhi Yu [aut, cre]

countryatlas_1.0.0.tar.gz
countryatlas_1.0.0.tar.gz(r-4.7-any)countryatlas_1.0.0.tar.gz(r-4.6-any)
countryatlas_1.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION |NEWS
card.svg |card.png
countryatlas/json (API)

# Install 'countryatlas' in R:
install.packages('countryatlas', repos = c('https://cran.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/pursuitofdatascience/countryatlas/issues

Pkgdown/docs site:https://pursuitofdatascience.github.io

Datasets:

On CRAN:

Conda:

3.40 score 8 scripts 31 exports 35 dependencies

Last updated from:ef6a7900bb. Checks:4 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK167
source / vignettesOK295
linux-release-x86_64OK190
wasm-releaseOK170

Exports:aggregate_regionsanimate_worldattach_geometryaudit_coveragebivariate_mapbubble_mapcartogram_mapcheck_country_matchclear_wdi_cachecomplete_yearsconvert_countrycountry_codescountry_datacountry_groupscountry_joinflow_mapgeom_country_labelsin_groupinteractive_mapjoin_worldper_capitarank_countriessimplify_geometrystandardize_countrytheme_world_maptile_mapwdi_searchwdj_overridesworld_dataworld_geometryworld_map

Dependencies:cachemclicountrycodecpp11dplyrfarverfastmapgenericsggplot2gluegtableisobandjsonlitelabelinglifecyclemagrittrmemoisepillarpkgconfigpurrrR6RColorBrewerrlangS7scalesstringistringrtibbletidyrtidyselectutf8vctrsviridisLiteWDIwithr

Beyond the choropleth
Proportional-symbol (bubble) maps | Equal-area tile grids | Flow maps | Labels | Maps that need optional packages

Last update: 2026-06-24
Started: 2026-06-24

countryatlas: Joining World Data to Maps on the ISO Spine
Abstract | Introduction | Core data assembly | world_data() | country_data() and attach_geometry() | Visualising: the choropleth and beyond | One-line choropleths | Proportional-symbol maps | Equal-area tile grids | Flow maps | The join engine | Diagnostics: never lose a country silently | Reference data and code translation | Analysis helpers | Performance and offline use | Conclusion | Session information

Last update: 2026-06-24
Started: 2026-06-24

Getting started
A map-ready tibble in one call | Your first choropleth | Choosing indicators | Next steps

Last update: 2026-06-24
Started: 2026-06-24

Joining your own data
Standardise any frame | One call to a map | Reconcile two messy tables | Check before you trust | Custom origins

Last update: 2026-06-24
Started: 2026-06-24

Modern maps with sf & projections
An equal-area, projected choropleth | Just the canvas | Recentring and the antimeridian | Region subsetting | Simplifying for the web

Last update: 2026-06-24
Started: 2026-06-24

Readme and manuals

Help Manual

Help pageTopics
Roll countries up to region / income / continentaggregate_regions
Animate a choropleth over timeanimate_world
Attach geometry to a country-level tableattach_geometry
Coverage / missingness auditaudit_coverage
Two-variable bivariate choroplethbivariate_map
Proportional-symbol (bubble) mapbubble_map
Area-honest cartogramcartogram_map
Pre-flight country-match reportcheck_country_match
Clear the on-disk / in-memory WDI cacheclear_wdi_cache
Curated indicator cataloguecommon_indicators
Fill or interpolate panel gapscomplete_years
Friendly country-code conversionconvert_country
The countrycode codelist as a tidy tibblecountry_codes
Lightweight one-row-per-country tablecountry_data
Country-group membershipcountry_groups
Country-group membership (point-in-time)country_groups_tbl
Reconcile and join two messy country tablescountry_join
Static per-country metadatacountry_meta
Great-circle origin-destination flow mapflow_map
Centroid-anchored country labelsgeom_country_labels
Is a country in a group?in_group
Web-ready interactive choroplethinteractive_map
One call: your data, on a mapjoin_world
Normalise an indicator by populationper_capita
Add rank, percentile and z-scorerank_countries
Simplify (thin) geometry for faster plottingsimplify_geometry
Add ISO codes and classifications to any data framestandardize_country
A clean theme for world mapstheme_world_map
Equal-area world tile gridtile_map
Search World Bank indicatorswdi_search
Curated country-name overrides (replaces the silent drop-list)wdj_overrides
Map-ready, enriched country tibbleworld_data
Geometry without the dataworld_geometry
One-line choropleth, several honest stylesworld_map
Offline snapshot of world dataworld_snapshot
Equal-area world tile-grid layoutworld_tiles