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.
The OHDSI GIS Working Group maintains and develops several interconnected repositories that together form the Gaia toolchain:
OHDSI/GIS (this repository)
- Central documentation and coordination hub
- OMOP GIS schema extensions
- Use case tracking and project management
- Developer guidelines and contribution workflows
- 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
- 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)
- Metadata catalog for geospatial data sources
- Schema.org-compliant data discovery
- Federated metadata sharing
- Containerized deployment of Gaia toolchain
- Coordinated image builds and versioned releases
- Docker Compose orchestration
- Complete GIS stack deployment
- 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
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
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
Instructions to quickly install and start using Gaia are here
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 -dThen connect from R with the gaiaCore package (also available as the image ohdsi/gaia-core); see the gaiaCore documentation.
docker compose --profile gaia down- Developer questions/comments/feedback: OHDSI Forum
- Please use the GitHub issue tracker for all bugs/issues/enhancements
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.
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.
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