Documentation for fhir-to-omop Mapping

All of the information used to map FHIR messages to OMOP data are in the documents listed below.

References

These pages are the main sources of information regarding FHIR to OMOP used to create this implementation.

Document  Description 
FHIR: Publication (Version) History This is the page with links to documenation for the different versions of FHIR.
The primary versions used to inform this implementation are:
FHIR: Using Codes in Resources (STU3) This is the main page for Terminologies for FHIR STU3.
Versions used for this implementation
FHIR: MaxMD FHIR Bundle Viewer This is a good online tool that can be used to visualize raw FHIR messages as HTML.
OHDSI: Common Data Model Version 5.4

This is the page that has the table definitions and column definitions for the OHDHSI OMOP Common Data Model Version 5.4.0

"Each table is represented with a high-level description and ETL conventions that should be followed. This is continued with a discussion of each field in each table, any conventions related to the field, and constraints that should be followed (like primary key, foreign key, etc)."

OHDSI: Main page The Observational Health Data Sciences and Informatics (or OHDSI, pronounced "Odyssey") program is a multi-stakeholder, interdisciplinary collaborative to bring out the value of health data through large-scale analytics. All our solutions are open-source.
OHDSI: The Book of OHDSI This is a book about the Observational Health Data Sciences and Informatics (OHDSI) collaborative. The OHDSI community wrote the book to serve as a central knowledge repository for all things OHDSI. The Book is a living document, community-maintained through open-source development tools, and evolves continuously. The online version, available for free at http://book.ohdsi.org, always represents the latest version. A physical copy of the book is available from Amazon at cost price.

Documentation for fhir-to-omop Mapping

The articles listed below represent the exact methods used by this implementation to map HL7 FHIR to OMOP.

Document  Description 
Terminology Mapping This document describes how NAHCH fhir-to-omop tools map FHIR Systems and codes to OMOP vocabulary_id and concept values. It should be noted that an approved mapping for FHIR Systems to OMOP vocabulary_id values does not exist. The mapping we are using was provided as a draft solution as described in this Stackoverflow post.
Race & Ethnicity Mapping This page details how the NACHC fhir-to-omop tools have defined Race and Ethnicity codes.
PERSON This document details the design and decisions for the mapping of FHIR Patient resources to the OMOP PERSON Table.
VISIT_OCCURRENCE This document details the design and decisions for the mapping of FHIR Encounter resources to the OMOP VISIT_OCCURRENCE Table.
PROCEDURE This document details the design and decisions for the mapping of FHIR Procedure resources to OMOP entities and attributes.
MEASUREMENT This document details the design and decisions for the mapping of FHIR Observation and Procedure resources to OMOP MEASUREMENT entities and attributes.
OBSERVATION This document details the design and decisions for the mapping of FHIR Observation and Procedure resources to OMOP OBSERVATION entities and attributes.
DRUG_EXPOSURE This document details the design and decisions for the mapping of FHIR Medication Request resources to OMOP DRUG_EXPOSURE entities and attributes.