Skip to content

Latest commit

 

History

History
87 lines (64 loc) · 4.63 KB

README.md

File metadata and controls

87 lines (64 loc) · 4.63 KB

tigris

R build status CRAN Badge CRAN Downloads

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')

tigris functions return simple features objects with a default year of 2022, though later years are available (tigris maintains consistency with the most recent 5-year American Community Survey). 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.

To learn more about how to use tigris, read Chapter 5 of the book Analyzing US Census Data: Methods, Maps, and Models in R.

Python users may also be interested in pygris, a Python port of the tigris package.

Available datasets:

Please note: cartographic boundary files in tigris are not available for 2011 and 2012.

Function Datasets available Years available
nation() cartographic (1:5m; 1:20m) 2013-2023
divisions() cartographic (1:500k; 1:5m; 1:20m) 2013-2023
regions() cartographic (1:500k; 1:5m; 1:20m) 2013-2023
states() TIGER/Line; cartographic (1:500k; 1:5m; 1:20m) 1990, 2000, 2010-2024
counties() TIGER/Line; cartographic (1:500k; 1:5m; 1:20m) 1990, 2000, 2010-2024
tracts() TIGER/Line; cartographic (1:500k) 1990, 2000, 2010-2024
block_groups() TIGER/Line; cartographic (1:500k) 1990, 2000, 2010-2024
blocks() TIGER/Line 2000, 2010-2024
places() TIGER/Line; cartographic (1:500k) 2011-2024
pumas() TIGER/Line; cartographic (1:500k) 2012-2024
school_districts() TIGER/Line; cartographic 2011-2024
zctas() TIGER/Line; cartographic (1:500k) 2000, 2010, 2012-2024
congressional_districts() TIGER/Line; cartographic (1:500k; 1:5m; 1:20m) 2011-2024
state_legislative_districts() TIGER/Line; cartographic (1:500k) 2011-2024
voting_districts() TIGER/Line 2012, 2020
area_water() TIGER/Line 2011-2024
linear_water() TIGER/Line 2011-2024
coastline TIGER/Line() 2013-2024
core_based_statistical_areas() TIGER/Line; cartographic (1:500k; 1:5m; 1:20m) 2011-2021, 2023-2024 (not available for 2022)
combined_statistical_areas() TIGER/Line; cartographic (1:500k; 1:5m; 1:20m) 2011-2024
metro_divisions() TIGER/Line 2011-2024
new_england() TIGER/Line; cartographic (1:500k) 2011-2022 (no longer used by Census)
county_subdivisions() TIGER/Line; cartographic (1:500k) 2010-2024
urban_areas() TIGER/Line; cartographic (1:500k) 2012-2024
primary_roads() TIGER/Line 2011-2024
primary_secondary_roads() TIGER/Line 2011-2024
roads() TIGER/Line 2011-2024
rails() TIGER/Line 2011-2024
native_areas() TIGER/Line; cartographic (1:500k) 2011-2024
alaska_native_regional_corporations() TIGER/Line; cartographic (1:500k) 2011-2024
tribal_block_groups() TIGER/Line 2011-2024
tribal_census_tracts() TIGER/Line 2011-2024
tribal_subdivisions_national() TIGER/Line 2011-2024
landmarks() TIGER/Line 2011-2024
military() TIGER/Line 2011-2024