Opioid Environment Policy Scan (OEPS)

The Opioid Environment Policy Scan (OEPS) is an open source data ecosystem that helps characterize the multi-dimensional risk environment impacting opioid use and health outcomes across the United States.

This code base holds the all components of the OEPS project, including the CSV files that contain the raw data itself.

• OEPS Documentation: healthyregions.github.io/oeps
  • The full, technical documentation deployed via Github pages.
  • Start here if you are looking to learn about how OEPS is put together, or are a developer that will be working on this code base.
• OEPS Explorer: oeps.healthyregions.org
  • The OEPS Explorer is a NextJS app built from WebGeoda (which uses jsGeoDa) for geospatial interactivity.
• OEPS Backend
  • The backend is a Flask app that manages the many variables and datasets that makeup the OEPS data warehouse.
  • The backend uses Frictionless Standards internally and features multiple export pipelines to different systems.
  • The backend holds a registry as well as the raw CSV data itself.

See also:

• oepsData: An R data package wrapper around OEPS data
• GeoDaCenter/opioid-policy-scan: The original OEPS data repository (see legacy-migration for more information about how this repository relates to that one)

About OEPS

OEPS provides access to data at multiple spatial scales, from U.S. states down to Census tracts, as well different time periods, with data from 1980 to today. It is designed to support research seeking to study environments impacting and impacted by opioid use and opioid use disorder (OUD), inform public policy, and reduce harm in communities nationwide.

Variable constructs have been grouped thematically to highlight the multi-dimensional risk environment of opioid use in justice populations. The variable themes are: Geography, Social, Environment, Economic, Policy, Outcome, and Composite.

Credits

This project is led by the Healthy Regions & Policies Lab in the Department of Geography and GIScience at the University of Illinois, Urbana-Champaign.

v1 Citation

Susan Paykin, Dylan Halpern, Qinyun Lin, Moksha Menghaney, Angela Li, Rachel Vigil, Margot Bolanos Gamez, Alexa Jin, Ally Muszynski, and Marynia Kolak. (2021). GeoDaCenter/opioid-policy-scan: Opioid Environment Policy Scan Data Warehouse (v1.0). Zenodo. http://doi.org/10.5281/zenodo.4747876

v2 Citation

Adam Cox, Ashlynn Wimer, Sara Lambert, Susan Paykin, Dylan Halpern, Qinyun Lin, Moksha Menghaney, Angela Li, Rachel Vigil, Margot Bolanos Gamez, Alexa Jin, Ally Muszynski, and Marynia Kolak. (2024). healthyregions/oeps: Opioid Environment Policy Scan (OEPS) Data Warehouse (v2.0). Zenodo. https://doi.org/10.5281/zenodo.5842465

Development Notes

Updates to the database, documentation, or web mapping infrastructure should only be completed by engineers who have completed training and understand the full OEPS documentation.

For lighter updates to web pages, team members can use the following approach. To run the server locally when posting web page updates, you'll need to do the following:

• Make a new branch for your updates
• Navigate to the appropriate page in "explorer/pages/.."
• Make changes to the page you need (index, about, etc.) in your IDE
• Navigate to the explorer folder using Terminal. Ensure yarn is working on your system.
• To re-build the pages after your edit, run yarn build
• To start the server, run yarn start
• Go to http://localhost:3000/ to see the updates live
• Remember, you can stop the server using control C
• When all updates have completed, push to your branch.

Submit a pull request when complete.