Skip to content
OHDSIPublic

About

Resources

Contributing

Stars

20 stars

Watchers

13 watching

Forks

Repository files navigation

OHDSI GIS Workgroup

Introduction

Welcome to the OHDSI Geographic Information Systems (GIS) Working Group – the central hub for integrating geospatial and person-level health data within the OHDSI ecosystem.

Mission: Improve the health of populations by generating reliable evidence from integrated geospatial and person-level health data.

Please visit our webpage for more details and the most up-to-date information and software documentation.

For project management, see the GIS Project Page

Click here to propose a new Use Case.

GIS Working Group Ecosystem

The OHDSI GIS Working Group maintains and develops several interconnected repositories that together form the Gaia toolchain:

Core Infrastructure Repositories

OHDSI/GIS (this repository)

  • Central documentation and coordination hub
  • OMOP GIS schema extensions
  • Use case tracking and project management
  • Developer guidelines and contribution workflows

OHDSI/gaiaDb

  • PostgreSQL/PostGIS database serving as the core data repository
  • Geospatial data ingestion, management, and analysis
  • SQL routines and PostGIS functionality
  • OMOP CDM integration
  • LinkML/JSON-LD metadata support

OHDSI/gaiaCore

  • R package for working with gaiaDB, connecting directly through DatabaseConnector
  • Runs the Gaia pipeline from R: ingestion, location loading, the spatial-temporal join
  • Quality checks on derived exposure and copy into the OMOP CDM
  • Exposure analytics (day-weighted windows, cluster-robust effect estimates)
  • Docker image ohdsi/gaia-core (HADES with gaiaCore and the extension packages)

OHDSI/gaiaCatalog

  • Metadata catalog for geospatial data sources
  • Schema.org-compliant data discovery
  • Federated metadata sharing

OHDSI/gaiaDocker

  • Containerized deployment of Gaia toolchain
  • Coordinated image builds and versioned releases
  • Docker Compose orchestration
  • Complete GIS stack deployment

Vocabulary Resources

TuftsCTSI/CVB

  • OMOP GIS Vocabulary Package delta files
  • OMOP Exposome Vocabulary
  • OMOP SDoH (Social Determinants of Health) Vocabulary
  • Toxins and environmental exposure vocabularies

Find the Delta Vocabulary files for the Vocabulary Package here

Our Work

The OMOP GIS (Geographic Information System) Vocabulary Package is designed to elevate data-driven healthcare research by enabling the integration of spatial, environmental, behavioral, socioeconomic, phenotypic, and toxin-related determinants of health into standardized data structures. Features:

  • OMOP GIS Vocabulary
  • OMOP Exposome Vocabulary
  • OMOP SDoH (Social Determinants of Health) Vocabulary

Gaia Toolchain

The Gaia toolchain provides end-to-end support for integrating geospatial data with OMOP CDM:

  • gaiaDB: PostgreSQL/PostGIS database with geospatial data processing, SQL routines, and OMOP integration
  • gaiaCore: R package that runs the Gaia pipeline against gaiaDB, checks the derived exposure and provides exposure analytics
  • gaiaCatalog: Data discovery and metadata management
  • gaiaDocker: Containerized deployment with coordinated image builds and versioned releases

Quick Start

Instructions to quickly install and start using Gaia are here

Docker Quick Start

Prerequisite: this solution requires that you have Docker and Docker Compose installed. See here.

The whole stack (gaiaDB, the catalog and the gaia-core RStudio image with the gaiaCore R package) is deployed with gaiaDocker:

git clone https://github.com/OHDSI/gaiaDocker.git
cd gaiaDocker
docker compose --profile gaia up -d

Then connect from R with the gaiaCore package (also available as the image ohdsi/gaia-core); see the gaiaCore documentation.

docker compose --profile gaia down

Support

Contributing

We are eager to engage with interested developers with interest or experience in frontend, backend, and geospatial development.

If you are interested in contributing and don't know where to begin, please join the OHDSI GIS WG or email at zollovenecek[at]ohdsi[dot]org

See Developer Resources for detailed contributing guidelines.

Citing

DOI

Cite the toolchain with the Zenodo record: 10.5281/zenodo.23296291 (all versions; it always resolves to the latest release). To cite the exact snapshot behind the manuscript, use version 1.0.1 (tag benchmark-v1.0.1): 10.5281/zenodo.23296292. GitHub's "Cite this repository" button uses CITATION.cff. All releases are listed under Releases. The accompanying article will be added to the citation after publication.

Building Documentation

This repository uses RMarkdown to generate documentation hosted on GitHub Pages. To build the site locally:

# Quick start
Rscript build-site.R

# Or using R console
setwd("rmd")
rmarkdown::render_site(encoding = "UTF-8")

For detailed build instructions, see BUILD.md

About

Resources

Contributing

Stars

20 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages