⚠️There's a newer version (1.5) of this package. Take me there.

tigris

tigris is an R package that allows users to directly download and use TIGER/Line shapefiles (https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) from the US Census Bureau.

To install the package from CRAN, issue the following command in R:

install.packages('tigris')

Or, get the development version from GitHub:

devtools::install_github('walkerke/tigris')

As of version 1.0 (released in July 2020), tigris functions return simple features objects with a default year of 2019. To get started, choose a function from the table below and use it with a state and/or county if required. You'll get back an sf object for use in your mapping and spatial analysis projects:

library(tigris)
library(ggplot2)

manhattan_roads <- roads("NY", "New York")

ggplot(manhattan_roads) + 
  geom_sf() + 
  theme_void()

tigris only returns feature geometries for US Census data which default to the coordinate reference system NAD 1983 (EPSG: 4269). For US Census demographic data (optionally pre-joined to tigris geometries), try the tidycensus package. For help deciding on an appropriate coordinate reference system for your project, take a look at the crsuggest package.

Updated documentation for tigris is coming later this year in the book Analyzing the US Census with R. In the meantime, I'd recommend the following materials to learn about conceptual foundations of the package:

Available datasets:

Please note: cartographic boundary files in tigris are not available for 2011 and 2012. While many datasets are available for 2020 geographies, the cartographic boundary shapefiles for 2020 have not yet been released as of May 2021.

FunctionDatasets availableYears available
nation()cartographic (1:5m; 1:20m)2013-2019
divisions()cartographic (1:500k; 1:5m; 1:20m)2013-2019
regions()cartographic (1:500k; 1:5m; 1:20m)2013-2019
states()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)1990, 2000, 2010-2020
counties()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)1990, 2000, 2010-2020
tracts()TIGER/Line; cartographic (1:500k)1990, 2000, 2010-2020
block_groups()TIGER/Line; cartographic (1:500k)1990, 2000, 2010-2020
blocks()TIGER/Line2000, 2010-2020
places()TIGER/Line; cartographic (1:500k)2011-2020
pumas()TIGER/Line; cartographic (1:500k)2012-2020
school_districts()TIGER/Line; cartographic2011-2020
zctas()TIGER/Line; cartographic (1:500k)2000, 2010, 2012-2020
congressional_districts()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2020
state_legislative_districts()TIGER/Line; cartographic (1:500k)2011-2020
voting_districts()TIGER/Line2012
area_water()TIGER/Line2011-2020
linear_water()TIGER/Line2011-2020
coastlineTIGER/Line()2013-2020
core_based_statistical_areas()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2020
combined_statistical_areas()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2020
metro_divisions()TIGER/Line2011-2020
new_england()TIGER/Line; cartographic (1:500k)2011-2020
county_subdivisions()TIGER/Line; cartographic (1:500k)2010-2020
urban_areas()TIGER/Line; cartographic (1:500k)2012-2020
primary_roads()TIGER/Line2011-2020
primary_secondary_roads()TIGER/Line2011-2020
roads()TIGER/Line2011-2020
rails()TIGER/Line2011-2020
native_areas()TIGER/Line; cartographic (1:500k)2011-2020
alaska_native_regional_corporations()TIGER/Line; cartographic (1:500k)2011-2020
tribal_block_groups()TIGER/Line2011-2020
tribal_census_tracts()TIGER/Line2011-2020
tribal_subdivisions_national()TIGER/Line2011-2020
landmarks()TIGER/Line2011-2020
military()TIGER/Line2011-2020

Copy Link

Version

Down Chevron

Install

install.packages('tigris')

Monthly Downloads

10,626

Version

1.4.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Last Published

June 18th, 2021

Functions in tigris (1.4.1)