The DeGAUSS geocoder relies on offline TIGER/Line data useful for geocoding private health information. View the geocoder homepage for more information.

Input address data formatting

Addresses must be stored as a CSV file and follow these formatting requirements:

Using the DeGAUSS geocoder

  1. Start Docker.

  2. If using MacOS, open the terminal application. For Windows, use the command prompt or powershell.

  3. Navigate to the working directory where your address file is located. For example, if your file is saved to the Desktop, use cd Desktop. See here for more information on file navigation.

  4. Enter the DeGAUSS command. See the example below:

If my_address_file.csv is a file in the current working directory with an address column named address, then

docker run --rm -v $PWD:/tmp degauss/geocoder:3.0.1 my_address_file.csv

will produce my_address_file_geocoded_v3.0.csv with added columns including lat, lon, and geocoding diagnostic information.

Note: If you are using a Windows machine to run Docker, please review this page for Windows-specific changes that likely need to be made to successfully use DeGAUSS. You can ignore this if you are using macOS or linux.

Interpreting geocoding results

The geocoder’s output file includes the following columns:

Missing geocoding results