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 and working with FIPS codes are also provided.
Typically in R it is difficult to create nice US choropleths that include Alaska and Hawaii. The functions presented here attempt to elegantly solve this problem by manually moving these states to a new location and providing a fortified data frame for mapping and visualization. This allows the user to easily add data to color the map.
The shape files that we use to plot the maps in R are located in the
data-raw folder. For more information refer to the US Census Bureau. Maps at both the state and county levels are included for convenience (zip code maps may be included in the future).
To install from CRAN (recommended), run the following code in an R console:
To install the package from this repository, run the following code in an R console:
devtools::install_github will provide the most recent developer build of
To begin using
usmap, simply import the package using the
To read the package vignettes, which explain helpful uses of the package, use
vignette(package = "usmap")vignette("introduction", package = "usmap")vignette("mapping", package = "usmap")
You can also read the vignettes online at the following links:
state_map <- us_map(regions = "states")county_map <- us_map(regions = "counties")
new_england_states <- c("Connecticut", "Maine", "Massachusetts", "New Hampshire", "Rhode Island", "Vermont")new_england_map <- us_map(regions = "states", include = new_england_states)
fips("New Jersey")#> "34"fips("NJ", county = "Mercer")#> "34021"
fips_info(c("34", "35"))#> full abbr fips#> 1 New Jersey NJ 34#> 2 New Mexico NM 35fips_info(c("34021", "35021"))#> full abbr county fips#> 1 New Jersey NJ Mercer County 34021#> 2 New Mexico NM Harding County 35021
plot_usmap(data = statepop, values = "pop_2015", lines = "red") +scale_fill_continuous(name = "Population (2015)", label = scales::comma) +theme(legend.position = "right")
library(usmap)library(ggplot2)# States mapplot_usmap(data = statepop, values = "pop_2015") +scale_fill_continuous(low = "white", high = "red", guide = FALSE) +scale_x_continuous(expand = c(0, 0)) + scale_y_continuous(expand = c(0, 0))# Counties mapplot_usmap(data = countypop, values = "pop_2015") +scale_fill_continuous(low = "white", high = "red", guide = FALSE) +scale_x_continuous(expand = c(0, 0)) + scale_y_continuous(expand = c(0, 0))
plot_usmapto contain FIPS codes with missing leading zeros.
map_with_datafunction for adding user-defined data to map data.