usmap: Mapping the US

Paolo Di Lorenzo

2019-09-12

Extending plot_usmap with ggplot2

The nice thing about usmap::plot_usmap is it returns a ggplot object object, which means we can add ggplot layers to the plot right out of the box.

library(usmap)
library(ggplot2)

plot_usmap(regions = "counties") + 
  labs(title = "US Counties",
       subtitle = "This is a blank map of the counties of the United States.") + 
  theme(panel.background = element_rect(color = "black", fill = "lightblue"))

Plot only certain states

Add some data to the map

Notice the comprehensive expandability that can be applied to the map using ggplot2 layers. For example, we might want to use a different color scheme.

Change fill color scale

The data-filled map can also be filtered to show certain regions only, like the western states shown above.

Show data in certain states

Built-in Regions

usmap provides some built-in regions based on the US Census Bureau Regions and Divisions. These can be used in place of the include/exclude parameters when using us_map or plot_usmap and start with a . (dot):

usmap::plot_usmap(include = .south_region)

usmap::plot_usmap(include = .east_south_central)

usmap::plot_usmap(include = .south_region, exclude = .east_south_central)

This also works with county maps. The regions can also be combined with actual state or FIPS values within the include/exclude parameters:

usmap::plot_usmap("counties", 
                  include = c(.south_region, "IA"), 
                  exclude = c(.east_south_central, "12"))  # 12 = FL

You can even include or exclude individual counties (county-level inclusions/exclusions can only be done via their FIPS codes due to duplicate county names across states; for example eight different states have an “Orange County”):

usmap::plot_usmap("counties", fill = "yellow", alpha = 0.25,
                  # 06065 = Riverside County, CA
                  include = c(.south_region, "IA", "06065"),
                  # 12 = FL, 48141 = El Paso County, TX
                  exclude = c(.east_south_central, "12", "48141"))

These parameters therefore allow for the possibility of some complex compositions of states and counties, to create the exact map that is desired.

Supported US Census Regions and Divisions

The following divisions are supported:

Regions are composed of multiple divisions, and the following are supported:

Raw map data

The raw US map data for counties or states can be obtained for further manipulation (and joining with data).

str(usmap::us_map())
#> 'data.frame':    12999 obs. of  9 variables:
#>  $ x    : num  1091779 1091268 1091140 1090940 1090913 ...
#>  $ y    : num  -1380695 -1376372 -1362998 -1343517 -1341006 ...
#>  $ order: int  1 2 3 4 5 6 7 8 9 10 ...
#>  $ hole : logi  FALSE FALSE FALSE FALSE FALSE FALSE ...
#>  $ piece: int  1 1 1 1 1 1 1 1 1 1 ...
#>  $ group: chr  "01.1" "01.1" "01.1" "01.1" ...
#>  $ fips : chr  "01" "01" "01" "01" ...
#>  $ abbr : chr  "AL" "AL" "AL" "AL" ...
#>  $ full : chr  "Alabama" "Alabama" "Alabama" "Alabama" ...
str(usmap::us_map(regions = "counties"))
#> 'data.frame':    54187 obs. of  10 variables:
#>  $ x     : num  1225889 1244873 1244129 1272010 1276797 ...
#>  $ y     : num  -1275020 -1272331 -1267515 -1262889 -1295514 ...
#>  $ order : int  1 2 3 4 5 6 7 8 9 10 ...
#>  $ hole  : logi  FALSE FALSE FALSE FALSE FALSE FALSE ...
#>  $ piece : int  1 1 1 1 1 1 1 1 1 1 ...
#>  $ group : chr  "01001.1" "01001.1" "01001.1" "01001.1" ...
#>  $ fips  : chr  "01001" "01001" "01001" "01001" ...
#>  $ abbr  : chr  "AL" "AL" "AL" "AL" ...
#>  $ full  : chr  "Alabama" "Alabama" "Alabama" "Alabama" ...
#>  $ county: chr  "Autauga County" "Autauga County" "Autauga County" "Autauga County" ...

You can also include only certain states and counties just like in plot_usmap. In fact, the regions and include parameters of plot_usmap are derived directly from their usage in us_map.