Skip to content
@healthyregions

Healthy Regions & Policies Lab

We integrate innovative GIScience, public health, and statistical approaches to explore, understand, and promote healthy places.

Healthy Regions & Policies Lab

Visit healthyregions.org to learn about our recent projects and team. Here on Github you can explore all of our open source projects, and access some general data resources that we use internally.

HEROP_IDs

In some of our projects we use what we call a HEROP_ID to identify geographic boundaries defined by the US Census Bureau, which is a slight variation on the commonly used standard GEOID. Our format is similar to what the American FactFinder used (now data.census.gov).

A HEROP_ID consists of three parts:

  1. The 3-digit Summary Level Code for this geography. Common summary level codes are:
    • 040 -- State
    • 050 -- County
    • 140 -- Census Tract
    • 150 -- Census Block Group
    • 860 -- Zip Code Tabulation Area (ZCTA)
  2. The 2-letter string US
  3. The standard GEOID for the given unit (length depends on unit summary)
    • GEOIDs are, in turn, hierarchical aggregations of FIPS codes

Expanding out the FIPS codes for the five summary levels shown above, the full IDs would look like:

summary level format length example
State 040US + STATE (2) 7 040US17 (Illinois)
County 050US + STATE (2) + COUNTY (3) 10 050US17019 (Champaign County)
Tract 140US + STATE (2) + COUNTY (3) + TRACT (6) 16 140US17019005900
Block Group 150US + STATE (2) + COUNTY (3) + TRACT (6) + BLOCK GROUP (1) 17 150US170190059002
ZCTA 860US + ZIP CODE (5) 10 860US61801

The advantages of this composite ID are:

  1. Unique across all geographic areas in the US
  2. Will always be forced to string formatting
  3. Easy to programmatically change back into the more standard GEOIDs

Convert to GEOID (integers)

The HEROP_ID can be converted back to standard GEOIDs by removing the first 5 characters, or by taking everything after the substring "US". Here are some examples of what this looks like in different software:

  • Excel: REPLACE(A1, 1, 5, "")
  • R: geoid <- str_split_i(HEROP_ID, "US", -1)
  • Python: geoid = HEROP_ID.split("US")[1]
  • JavaScript: const geoid = HEROP_ID.split("US")[1]
Download Census geography files

Within the backend of our OEPS project we have an ETL pipeline that merges, tranforms, and exports data files from the US Census Bureau into a few different geospatial data formats. There are two categories of files:

  • Cartographic Boundaries have simplified geometries which makes them ideal for mapping applications learn more
    • We typically use the 500k scale files, though they publish other scales as well
  • TIGER/Line Shapefiles have official, unsimplified geometries and should be used for geospatial analysis learn more
    • We don't have these in the pipeline yet, but hope to eventually...

Feel free to download and use these for your own projects.

  • GeoJSON A simple plain text format that is good for small to medium size datasets and can be used in a wide variety of web and desktop software learn more
  • Shapefiles Used in scripting and desktop software for performant display and analysis learn more
    • Tip: geopandas should allow you to directly open remote zip files with something like this learn more:

        import geopandas as gpd
        gpd.read_file('/vsizip//vsicurl/https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2010-shp.zip
      
  • PMTiles A "cloud-native" vector format that is very fast in the right web mapping environment learn more

Cartographic Boundaries 2010 (500k)

Geography Format Link
State GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2010-500k.geojson
State Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2010-500k-shp.zip
State PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2010-500k.pmtiles
County GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2010-500k.geojson
County Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2010-500k-shp.zip
County PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2010-500k.pmtiles
Tract GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2010-500k.geojson
Tract Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2010-500k-shp.zip
Tract PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2010-500k.pmtiles
Block group GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2010-500k.geojson
Block group Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2010-500k-shp.zip
Block group PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2010-500k.pmtiles

Note: We don't yet have ZCTA and Place geographies for 2010.

Cartographic Boundaries 2018 (500k)

Geography Format Link
State GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2018-500k.geojson
State Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2018-500k-shp.zip
State PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/state-2018-500k.pmtiles
County GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2018-500k.geojson
County Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2018-500k-shp.zip
County PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/county-2018-500k.pmtiles
ZCTA GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/zcta-2010-500k.geojson
ZCTA Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/zcta-2010-500k-shp.zip
ZCTA PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/zcta-2010-500k.pmtiles
Place GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/place-2018-500k.geojson
Place Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/place-2018-500k-shp.zip
Place PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/place-2018-500k.pmtiles
Tract GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2018-500k.geojson
Tract Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2018-shp.zip
Tract PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/tract-2018-500k.pmtiles
Block group GeoJSON https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2018-500k.geojson
Block group Shapefile (zip) https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2018-500k-shp.zip
Block group PMTiles https://herop-geodata.s3.us-east-2.amazonaws.com/oeps/bg-2018-500k.pmtiles
Web maps and static site hosting

We have a system in place for using Github pages to host our work. One thing to consider when you publish your web app or map is what your want your URL to look like. Consider these approaches:

1. As a subdirectory of maps.healthyregions.org

Example: maps.healthyregions.org/<myproject>

This is more or less the easiest way to integrate your project into our domain. Just create your Github repository with your app as an index.html file in the root, and ask that lab staff add your repo as a submodule in this repository: healthyregions/mapping-projects. No need to deal with Github pages on your repository.

2. Subdomain under healthyregions.org

Example: <myproject>.healthyregions.org

In this case you must publish your Github pages repository like normal, and then request that we update our healthyregions DNS to make a subdomain for your project. This will require some extra configuration in your Github pages settings.

3. Your default Github pages domain

Example: <username>.github.io/<myproject>

You can also just independently publish a github repo if you want--no need to integrate with our domain name or URL at all. Just follow the usual steps for getting started Github pages.

4. Custom domain

Example: <myproject>.com

Finally, you could always purchase your own domain myproject.com from a registrar like NameCheap or GoDaddy (there are a lot of them), publish your own Github repository with Github pages, and then connect the domain to Github pages. Keep in mind that you'll need to continue paying for this domain as long as you want your project to be online. Also, while there are a lot fun and cheap domains today (like $1/year for healthytime.store, as of this writing) prices can and will increase in the future.

Pinned Loading

  1. SDOHPlace SDOHPlace Public

    Landing page and data discovery application for SDOH Place Project.

    TypeScript 1 1

  2. oeps oeps Public

    Opioid Environment Policy Scan - data explorer and backend management

    JavaScript 1

  3. chicago-environment-explorer chicago-environment-explorer Public

    ChiVes harmonizes & standardizes environmental data across dozens of sources to make it accessible for full exploration, alongside a growing list of resources on the Chicago Environment, cultivated…

    JavaScript 9 1

  4. sdohplace-toolkit sdohplace-toolkit Public

    Toolkit for SDOH & Place Project

    CSS 4 1

Repositories

Showing 10 of 32 repositories
  • SDOHPlace Public

    Landing page and data discovery application for SDOH Place Project.

    healthyregions/SDOHPlace’s past year of commit activity
    TypeScript 1 GPL-3.0 1 11 2 Updated Jan 15, 2025
  • oeps Public

    Opioid Environment Policy Scan - data explorer and backend management

    healthyregions/oeps’s past year of commit activity
    JavaScript 1 GPL-3.0 0 22 (4 issues need help) 0 Updated Jan 15, 2025
  • SDOHPlace-MetadataManager Public

    A metadata manager application built with Flask that writes records to Apache Solr.

    healthyregions/SDOHPlace-MetadataManager’s past year of commit activity
    Python 2 GPL-3.0 1 5 2 Updated Jan 14, 2025
  • .github Public
    healthyregions/.github’s past year of commit activity
    0 0 0 0 Updated Jan 6, 2025
  • mapping-projects Public

    Web map repository for various projects from the Healthy Regions & Policies Lab.

    healthyregions/mapping-projects’s past year of commit activity
    HTML 0 0 0 0 Updated Jan 6, 2025
  • loud Public

    Project Site for the Loud Study: Measuring Access to Medications for Opioid Use Disorder

    healthyregions/loud’s past year of commit activity
    CSS 0 0 0 0 Updated Jan 6, 2025
  • sdohplace-toolkit Public

    Toolkit for SDOH & Place Project

    healthyregions/sdohplace-toolkit’s past year of commit activity
    CSS 4 MIT 1 0 0 Updated Dec 26, 2024
  • healthyregions/spatial-access’s past year of commit activity
    TypeScript 3 2 6 0 Updated Dec 17, 2024
  • oepsData Public

    An R package for easy access to the Opioid Environment Policy Scan (OEPS) datasets.

    healthyregions/oepsData’s past year of commit activity
    R 1 CC-BY-4.0 0 2 0 Updated Dec 10, 2024
  • gh-pages-template Public template
    healthyregions/gh-pages-template’s past year of commit activity
    HTML 0 GPL-3.0 0 0 0 Updated Dec 10, 2024

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…