Spatio-temporal NHGIS Crosswalks
This project will eventually be transferred to the
IPUMS project space.
This pacakge allows for the generation of temporal crosswalks of census geographic data built from the smallest intersecting units (atoms). Each row in a crosswalk represents a single atom and is comprised of a source ID (
geo+year+gj), a target ID (
geo+year+gj), and at least one column of weights. An example of a source ID is
bgp1990gj (block group parts from 1990) and an example of a target ID is
tr1990gj (tracts from 2010) — see
notebooks/data-subset-sample-workflow-bgp1990tr2010.ipynb for the
nhgis_bgp1990gj_to_tr1990gj crosswalk extract of Delaware. The weights are the interpolated proportions of source attributes that are are calculated as being within the target units. For a description of the algorithmic workflow see the General Crosswalk Construction Framework. Data from 1990 poses a specific problem due to the US Census Bureau not explicitly including blocks with no population/housing units in the summary files (SF1). For a description of the algorithmic workflow in the 1990 “no data” scenarios see Handling 1990 No-Data Blocks in Crosswalks. For more information of the base crosswalks see their technical details. For further description see Schroeder (2007).
Currently supported crosswalks include:
|1990 block group parts||2010 counties|
|2000 block group parts||2010 counties|
|1990 block group parts||2010 tracts|
|2000 block group parts||2010 tracts|
|1990 block group parts||2010 block groups|
|2000 block group parts||2010 block groups|
Planned supported crosswalks include:
|1990 block group parts||2012 tracts|
|2000 block group parts||2012 tracts|
|1990 block group parts||2012 block groups|
|2000 block group parts||2012 block groups|
- Schroeder, J. P. 2007. Target-density weighting interpolation and uncertainty evaluation for temporal analysis of census data. Geographical Analysis 39 (3):311–335.
- Proportionally-weighted Synthetic Atoms
- Synthetic Example
- Sample Workflow (see all here):
- Frequently Asked Questions
nhgisxwalk officially supports Python 3.6, 3.7, and 3.8. Please make sure that you are operating in a Python >= 3.6 environment. Install the most current development version of
nhgisxwalk by running:
$ pip install git+https://github.com/jGaboardi/nhgisxwalk
NHGISXWALK is under active development and contributors are welcome. If you have any suggestions, feature requests, or bug reports, please open new issues on GitHub. To submit patches, please review the
nhgisxwalk contributing guidelines before opening a pull request.
If you are having issues, please create an issue.
If you use
nhgisxwalk in a scientific publication, we would appreciate using the following citations:
- Steven Manson, Jonathan Schroeder, David Van Riper, and Steven Ruggles. IPUMS National Historical Geographic Information System: Version 14.0 [Database]. Minneapolis, MN: IPUMS. 2019. http://doi.org/10.18128/D050.V14.0
- James Gaboardi. jGaboardi/nhgisxwalk. Zenodo. 2020.
The package is licensed under the BSD 3-Clause license.
This project is funded through:
National Science Foundation Award #1825768: National Historical Geographic Information System