container build status


If my_address_file_geocoded.csv is a file in the current working directory with coordinate columns named lat and lon, then the DeGAUSS command:

docker run --rm -v $PWD:/tmp ghcr.io/degauss-org/census_block_group:0.6.0 my_address_file_geocoded.csv

will produce my_address_file_geocoded_census_block_group_0.6.0_2010.csv with added columns:

Optional Argument

The default census year is 2010, but can be changed by supplying an optional argument to the degauss command. For example,

docker run --rm -v $PWD:/tmp ghcr.io/degauss-org/census_block_group:0.5.0 my_address_file_geocoded.csv 1990

will produce my_address_file_geocoded_census_block_group_0.6.0_1990.csv, with columns called census_block_group_id_1990 and census_tract_id_1990.

Available years for census block group and census tract identifiers include 1990, 2000, 2010, and 2020. Additionally, tracts identifiers are available for 1970 and 1980.


For spatiotemporal data in which each location is associated with a specified date range, consider using the st_census_tract container, which adds census tract identifiers for the appropriate vintage (1970-2020) based on start_date and end_date for each input location.

Geomarker Methods

Geomarker Data

Block Group identifiers are defined as the concatenation of the state, county, tract, and block group fips identifiers (commonly called GISJOIN or GEOID in census data). All census tract identifiers are 11 digits and all census block group identifiers are 12 digits, with the exception of some 1990, 1980, and 1970 tracts that are 9 digits, resulting in 10 digit block group identifiers.

DeGAUSS Details

For detailed documentation on DeGAUSS, including general usage and installation, please see the DeGAUSS homepage.


Steven Manson, Jonathan Schroeder, David Van Riper, Tracy Kugler, and Steven Ruggles. IPUMS National Historical Geographic Information System: Version 15.0 [dataset]. Minneapolis, MN: IPUMS. 2020. http://doi.org/10.18128/D050.V15.0