{"id":16721482,"url":"https://github.com/fitnr/get-tiger","last_synced_at":"2026-01-03T11:07:10.140Z","repository":{"id":52585991,"uuid":"50981085","full_name":"fitnr/get-tiger","owner":"fitnr","description":"Make workflow for downloading Census geodata and joining it to survey data","archived":false,"fork":false,"pushed_at":"2021-12-06T14:55:47.000Z","size":845,"stargazers_count":38,"open_issues_count":1,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-22T02:45:50.164Z","etag":null,"topics":["census-api","gis-data","shapefile","tiger"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fitnr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-03T07:06:18.000Z","updated_at":"2024-04-22T15:19:02.000Z","dependencies_parsed_at":"2022-08-26T23:50:22.827Z","dependency_job_id":null,"html_url":"https://github.com/fitnr/get-tiger","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitnr%2Fget-tiger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitnr%2Fget-tiger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitnr%2Fget-tiger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fitnr%2Fget-tiger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fitnr","download_url":"https://codeload.github.com/fitnr/get-tiger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243727634,"owners_count":20338051,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["census-api","gis-data","shapefile","tiger"],"created_at":"2024-10-12T22:30:48.209Z","updated_at":"2026-01-03T11:07:10.102Z","avatar_url":"https://github.com/fitnr.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Get tiger\n\nA `make`-based tool for downloading Census [Tiger Line](http://www.census.gov/geo/maps-data/data/tiger.html) Shapefiles.\n\nGet-tiger uses `make`, a tried-and-true tool for processing series of files, to quickly download Census geodata. Then you have Shapefiles (or GeoJSON) ready to use in your favorite GIS.\n\n## Requirements\n\n* [Make](https://www.gnu.org/software/make/) (tested with GNU make 3.81, other versions should work fine)\n* [wget](https://www.gnu.org/software/wget/): a utility for downloading files that's probably already installed on your machine\n\nSome helper commands require [GDAL](https://gdal.org), is an open-source geospatial library that includes commmand-line tools for modifying GIS data. If you don't have access to GDAL, set the `GDAL=false` variable, and those commands will be skipped.\n\n## Install\n\n* Download or clone the repo and put the contents in the folder you would like to fill with GIS data.\n\n## Use\n\nRunning `make` will produce a list of Census geographies available for download:\n```bash\nmake\nAvailable data sets:\nDownload with make DATASET\nNATION - United States\n...\nUNSD - Unified school districts\nZCTA5 - Zip code tabulation areas\n```\n\nTo download one or more, run with name of the dataset, like so:\n````bash\n# Download the national and state files and data\nmake NATION STATE\n# Download county data and each state's tract data\nmake COUNTY TRACT\n````\n\nMake will run the commands to download the shapefiles and data from the Census, then join them. You'll see the commands run on your screen, sit back and enjoy the show. The files will end up in a directory called `2019/`. \n```bash\n\u003e make NATION STATE\nmkdir -p 2019/NATION\nwget -q -nc -t 10 --waitretry 1 --timeout 2 ftp://ftp2.census.gov/geo/tiger/GENZ2019/shp/cb_2019_us_nation_5m.zip -o 2019/NATION/cb_2019_us_nation_5m.zip\nmkdir -p 2019/STATE\nwget -q -nc -t 10 --waitretry 1 --timeout 2 ftp://ftp2.census.gov/geo/tiger/GENZ2019/shp/cb_2019_us_state_500k.zip -o 2019/STATE/cb_2019_us_state_500k.zip\n```\n\nSome commands will download many files. For instance, this will download files for the fifty states, DC and Puerto Rico:\n````bash\nmake PLACE\n````\n\nTo download only some states and territories, use the `STATE_FIPS` variable:\n````bash\n# Only New York\nmake PLACE STATE_FIPS=36\n\n# Only DC, Maryland and Virginia\nmake PLACE STATE_FIPS=\"11 24 51\"\n````\n\nYou may find a [list of state fips codes](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code) handy.\n\n## Which maps\n\nThe Census publishes two sets of map data: [Cartographic Boundary](http://www.census.gov/geo/maps-data/data/tiger-cart-boundary.html) files and [TIGER/Line](http://www.census.gov/geo/maps-data/data/tiger-line.html). The main difference is that cartographic boundaries files are clipped to the coastline. These are the default for `get-tiger`. The cartographic files are only available for some data sets. To always fetch TIGER/Line files, set `CARTOGRAPHIC=false`:\n```\nmake TRACT CARTOGRAPHIC=false\n```\n\n### Vintage\n\nBy default, the Makefile downloads 2019 data. For older years (or newer years, if it's the future), use the `YEAR` variable:\n```bash\nmake STATE YEAR=2013\nmake STATE YEAR=2015\n```\n\nThe `counties` folder contains a helper files for each year to track county FIPS codes. If you want to use a `YEAR` for which an `ini` file doesn't yet exist, use the small `ini.mk` Makefile try to create it by downloading the required county list:\n```\nmake -f ini.mk YEAR=2020\n```\n\n### Secret bonus tasks for merging data\n\nA relatively common task is to download a national set of geographies of a certain type. Run this to download a national dataset of block groups: \n```bash\nmake 2014/BG.shp\n```\nYou can add in options for different `DATA_FIELDS` as described above. To run this task for a different year, you'll need to change the year twice (`make 2019/BG.shp YEAR=2019`).\n\nGet-tiger includes shortcut tasks like this for the following geographies. They all follow the same pattern (`2014/\u003cNAME\u003e.shp`):\n\n* American Indian / Alaska Native Areas / Hawaiian Home Lands (`AIANNH`, `AITSN`, `ANRC`)\n* block groups and tribal block groups (`BG`, `TBG`)\n* blocks (`TABBLOCK`)\n* census tracts and tribal census tracts (`TRACT`, `TTRACT`)\n* congressional districts (`CD`)\n* consolidated cities (`CONCITY`)\n* counties (`COUNTY`)\n* counties within urban areas (`COUNTY_WITHIN_UA`)\n* county subdivisions (`COUSUB`)\n* metropolitan areas (`CBSA`, `CSA`, `METDIV`)\n* military bases (`MIL`)\n* New England stuff (`CNECTA`, `NECTA`, `NECTADIV`)\n* places (`PLACE`)\n* public use microdata areas (`PUMA`)\n* Puerto-Rico-specific subdivisions (`ESTATE`, `SUBBARRIO`)\n* railroads (`RAILS`)\n* roads (`ROADS`)\n* school districts (`UNSD`, `ELSD` and `SCSD`)\n* states (`STATE`)\n* state legislative districts (`SLDL`, `SLDU`)\n* urbanized areas (`UAC`)\n* water (`AREAWATER`, `LINEARWATER`)\n* zip code tabulations areas (`ZCTA5`)\n* high-level subdivisions (`NATION`, `DIVISION`, `REGION`)\n\n\n### Format\n\nThis thing spits out the zipped shapefiles downloaded from the census. For AREAWATER, LINEARWATER and ROADS, which come packaged as one file per county, the data is automatically merged to state-level unzipped shape files.\n\n## License\n\nCopyright 2016-2021 Neil Freeman. Available under the GNU General Public License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffitnr%2Fget-tiger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffitnr%2Fget-tiger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffitnr%2Fget-tiger/lists"}