usmap

1.0.0

US Maps Including Alaska and Hawaii

4packages depend

67.2Kdownloads / year

100.0%test coverage

13/13checks pass

Overview

About

Maintained by Paolo Di LorenzoFirst published 2017-01-2917 releasesCRAN page ↗GitHub ↗

Obtain United States map data frames of varying region types (e.g. county, state). The map data frames include Alaska and Hawaii conveniently placed to the bottom left, as they appear in most maps of the US. Convenience functions for plotting choropleths, visualizing spatial data, and working with FIPS codes are also provided.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("usmap", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("pdil/usmap")

Development version from pdil/usmap. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-usmap

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-usmap

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-usmap

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 3.8 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 2.20

100.0%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 669 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 100%
Return-value docs: 29%
References docs: 24%

Downloads

67.2K

CRAN downloads in the past year

Rank #2,040 · ~184/day · ~5.6K/mo

Releases R versions

Daily download trend is not available in this view yet.

2.9K30 days

11.3K90 days

67.2K1 year

Compare downloads with other packages →

Also on404 r2u41 autocran22 c2d4u

Repository

GitHub ↗ pdil/usmap

83Stars

20Forks

0Open issues

0Open PRs

17Releases

676Commits

5Contributors

rmappinggeodatadatacountiesstatesusafips

License GPL-3.0 · 676 commits · Last activity 2026-02-21 · +1.2% stars, 30d

Stars over time

2025-05-21 · 772026-07-26 · 83

Repository practices

Upstream repositoryBeta

10 development-tooling and community-health practices detected across 8 families in the upstream repository

Checks run against github.com/pdil/usmap on 2026-07-30.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Lint, format, editor (2)

lintrRStudio project

Coverage (1)

Codecov

Governance and community (2)

Issue templatesFunding

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.5.0

Imports (2)

rlang usmapdata

LinkingTo (0)

none

Suggests (12)

covr ggplot2 ggrepel knitr proto rmarkdown scales sf spelling testthat vdiffr withr

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

4direct

0indirect

PracTools cpsvote ecocomDP sugarglider

Code & Tests

Datasets

People & History

People (1)

Maintainer (1)

Paolo Di Lorenzo

Author, Copyright holder, Maintainer

Authors (1)

Paolo Di Lorenzo

Author, Copyright holder, Maintainer

Paolo Di Lorenzo

Author, Copyright holder, Maintainer

Package Timeline

17 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.0.0Latest
2025-08-29 · current release · diff ↗
0.8.0
2025-05-28 · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
0.7.1
2024-03-21 · diff ↗
0.7.0
2024-01-20 · diff ↗
0.6.4
2023-12-11 · diff ↗
0.6.3
2023-10-22 · diff ↗
0.6.2
2023-06-13 · diff ↗
R
R 4.3.0 released · 2023-04-21
0.6.1
2022-11-13 · diff ↗
R
R 4.2.0 released · 2022-04-22
0.6.0
2022-02-27 · diff ↗
R
R 4.1.0 released · 2021-05-18
0.5.2
2021-01-21 · diff ↗

Show 14 earlier events

unarchivedReturned to CRAN
2021-01-21
archivedRemoved from CRAN
2021-01-10
check problems were not corrected in time
0.5.1
2020-10-07 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.5.0
2019-09-13 · diff ↗
R
R 3.6.0 released · 2019-04-26
0.4.0
2018-09-16 · diff ↗
0.3.0
2018-06-03 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.2.1
2017-08-15 · diff ↗
0.2.0
2017-04-29 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.1.0
2017-01-29
R
R 3.3.0 released · 2016-05-03

Package metadata

First published: 2017-01-29
Total releases: 17 / 9 yrs
License: GPL (>= 3) OSI
Minimum R: ≥ 3.5.0
Bundled data: 152 KB / 7 files
Download size: 2.0 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →