OMOP/docs/background.html

683 lines
20 KiB
HTML
Raw Normal View History

2019-10-31 19:06:09 +00:00
<!DOCTYPE html>
<html>
2019-10-31 19:06:09 +00:00
<head>
<meta charset="utf-8" />
<meta name="generator" content="pandoc" />
<meta http-equiv="X-UA-Compatible" content="IE=EDGE" />
2019-10-31 19:06:09 +00:00
<title> OMOP CDM Background</title>
2019-10-31 19:06:09 +00:00
<script src="site_libs/header-attrs-2.25/header-attrs.js"></script>
<script src="site_libs/jquery-3.6.0/jquery-3.6.0.min.js"></script>
2019-10-31 19:06:09 +00:00
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link href="site_libs/bootstrap-3.3.5/css/cosmo.min.css" rel="stylesheet" />
<script src="site_libs/bootstrap-3.3.5/js/bootstrap.min.js"></script>
<script src="site_libs/bootstrap-3.3.5/shim/html5shiv.min.js"></script>
<script src="site_libs/bootstrap-3.3.5/shim/respond.min.js"></script>
<style>h1 {font-size: 34px;}
h1.title {font-size: 38px;}
h2 {font-size: 30px;}
h3 {font-size: 24px;}
h4 {font-size: 18px;}
h5 {font-size: 16px;}
h6 {font-size: 12px;}
code {color: inherit; background-color: rgba(0, 0, 0, 0.04);}
pre:not([class]) { background-color: white }</style>
<script src="site_libs/jqueryui-1.13.2/jquery-ui.min.js"></script>
2019-10-31 19:06:09 +00:00
<link href="site_libs/tocify-1.9.1/jquery.tocify.css" rel="stylesheet" />
<script src="site_libs/tocify-1.9.1/jquery.tocify.js"></script>
<script src="site_libs/navigation-1.1/tabsets.js"></script>
<link href="site_libs/highlightjs-9.12.0/default.css" rel="stylesheet" />
<script src="site_libs/highlightjs-9.12.0/highlight.js"></script>
<link href="site_libs/font-awesome-6.4.2/css/all.min.css" rel="stylesheet" />
<link href="site_libs/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet" />
2019-10-31 19:06:09 +00:00
<link rel='shortcut icon' type='image/x-icon' href='favicon.ico' />
2021-01-06 15:52:57 +00:00
<style type="text/css">
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
</style>
2019-10-31 19:06:09 +00:00
<style type="text/css">code{white-space: pre;}</style>
<script type="text/javascript">
if (window.hljs) {
hljs.configure({languages: []});
hljs.initHighlightingOnLoad();
if (document.readyState && document.readyState === "complete") {
window.setTimeout(function() { hljs.initHighlighting(); }, 0);
}
}
</script>
2021-01-06 15:52:57 +00:00
2022-07-27 01:48:28 +00:00
2019-10-31 19:06:09 +00:00
<link rel="stylesheet" href="style.css" type="text/css" />
<style type = "text/css">
.main-container {
max-width: 940px;
margin-left: auto;
margin-right: auto;
}
img {
max-width:100%;
}
.tabbed-pane {
padding-top: 12px;
}
.html-widget {
margin-bottom: 20px;
}
button.code-folding-btn:focus {
outline: none;
}
summary {
display: list-item;
}
2022-07-27 01:48:28 +00:00
details > summary > p:only-child {
display: inline;
}
pre code {
padding: 0;
}
2019-10-31 19:06:09 +00:00
</style>
<style type="text/css">
.dropdown-submenu {
position: relative;
}
.dropdown-submenu>.dropdown-menu {
top: 0;
left: 100%;
margin-top: -6px;
margin-left: -1px;
border-radius: 0 6px 6px 6px;
}
.dropdown-submenu:hover>.dropdown-menu {
display: block;
}
.dropdown-submenu>a:after {
display: block;
content: " ";
float: right;
width: 0;
height: 0;
border-color: transparent;
border-style: solid;
border-width: 5px 0 5px 5px;
border-left-color: #cccccc;
margin-top: 5px;
margin-right: -10px;
}
.dropdown-submenu:hover>a:after {
border-left-color: #adb5bd;
2019-10-31 19:06:09 +00:00
}
.dropdown-submenu.pull-left {
float: none;
}
.dropdown-submenu.pull-left>.dropdown-menu {
left: -100%;
margin-left: 10px;
border-radius: 6px 0 6px 6px;
}
</style>
<script type="text/javascript">
2019-10-31 19:06:09 +00:00
// manage active state of menu based on current page
$(document).ready(function () {
// active menu anchor
href = window.location.pathname
href = href.substr(href.lastIndexOf('/') + 1)
if (href === "")
href = "index.html";
var menuAnchor = $('a[href="' + href + '"]');
// mark the anchor link active (and if it's in a dropdown, also mark that active)
var dropdown = menuAnchor.closest('li.dropdown');
if (window.bootstrap) { // Bootstrap 4+
menuAnchor.addClass('active');
dropdown.find('> .dropdown-toggle').addClass('active');
} else { // Bootstrap 3
menuAnchor.parent().addClass('active');
dropdown.addClass('active');
}
// Navbar adjustments
var navHeight = $(".navbar").first().height() + 15;
var style = document.createElement('style');
var pt = "padding-top: " + navHeight + "px; ";
var mt = "margin-top: -" + navHeight + "px; ";
var css = "";
// offset scroll position for anchor links (for fixed navbar)
for (var i = 1; i <= 6; i++) {
css += ".section h" + i + "{ " + pt + mt + "}\n";
}
style.innerHTML = "body {" + pt + "padding-bottom: 40px; }\n" + css;
document.head.appendChild(style);
2019-10-31 19:06:09 +00:00
});
</script>
<!-- tabsets -->
<style type="text/css">
.tabset-dropdown > .nav-tabs {
display: inline-table;
max-height: 500px;
min-height: 44px;
overflow-y: auto;
border: 1px solid #ddd;
border-radius: 4px;
}
.tabset-dropdown > .nav-tabs > li.active:before, .tabset-dropdown > .nav-tabs.nav-tabs-open:before {
content: "\e259";
2019-10-31 19:06:09 +00:00
font-family: 'Glyphicons Halflings';
display: inline-block;
padding: 10px;
border-right: 1px solid #ddd;
}
.tabset-dropdown > .nav-tabs.nav-tabs-open > li.active:before {
content: "\e258";
2019-10-31 19:06:09 +00:00
font-family: 'Glyphicons Halflings';
border: none;
2019-10-31 19:06:09 +00:00
}
.tabset-dropdown > .nav-tabs > li.active {
display: block;
}
.tabset-dropdown > .nav-tabs > li > a,
.tabset-dropdown > .nav-tabs > li > a:focus,
.tabset-dropdown > .nav-tabs > li > a:hover {
border: none;
display: inline-block;
border-radius: 4px;
background-color: transparent;
2019-10-31 19:06:09 +00:00
}
.tabset-dropdown > .nav-tabs.nav-tabs-open > li {
display: block;
float: none;
}
.tabset-dropdown > .nav-tabs > li {
display: none;
}
</style>
<!-- code folding -->
<style type="text/css">
#TOC {
margin: 25px 0px 20px 0px;
}
@media (max-width: 768px) {
#TOC {
position: relative;
width: 100%;
}
}
@media print {
.toc-content {
/* see https://github.com/w3c/csswg-drafts/issues/4434 */
float: right;
}
}
2019-10-31 19:06:09 +00:00
.toc-content {
padding-left: 30px;
padding-right: 40px;
}
div.main-container {
max-width: 1200px;
}
div.tocify {
width: 20%;
max-width: 260px;
max-height: 85%;
}
@media (min-width: 768px) and (max-width: 991px) {
div.tocify {
width: 25%;
}
}
@media (max-width: 767px) {
div.tocify {
width: 100%;
max-width: none;
}
}
.tocify ul, .tocify li {
line-height: 20px;
}
.tocify-subheader .tocify-item {
font-size: 0.90em;
}
.tocify .list-group-item {
border-radius: 0px;
}
</style>
</head>
<body>
<div class="container-fluid main-container">
2019-10-31 19:06:09 +00:00
<!-- setup 3col/9col grid for toc_float and main content -->
<div class="row">
2019-10-31 19:06:09 +00:00
<div class="col-xs-12 col-sm-4 col-md-3">
<div id="TOC" class="tocify">
</div>
</div>
<div class="toc-content col-xs-12 col-sm-8 col-md-9">
<div class="navbar navbar-default navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
2022-07-27 01:48:28 +00:00
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-bs-toggle="collapse" data-target="#navbar" data-bs-target="#navbar">
2019-10-31 19:06:09 +00:00
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="index.html"><div><img src="ohdsi16x16.png"></img> OMOP Common Data Model </div></a>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li>
<a href="index.html">
<span class="fa fa-house"></span>
2019-10-31 19:06:09 +00:00
</a>
</li>
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-landmark"></span>
2019-10-31 19:06:09 +00:00
Background
<span class="caret"></span>
2019-10-31 19:06:09 +00:00
</a>
<ul class="dropdown-menu" role="menu">
<li>
<a href="background.html">Model Background</a>
</li>
<li>
<a href="cdmRefreshProcess.html">CDM Refresh Process</a>
</li>
<li>
<a href="vocabulary.html">How the Vocabulary is Built</a>
</li>
</ul>
2019-10-31 19:06:09 +00:00
</li>
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-list-alt"></span>
2019-10-31 19:06:09 +00:00
Conventions
<span class="caret"></span>
2019-10-31 19:06:09 +00:00
</a>
<ul class="dropdown-menu" role="menu">
<li>
<a href="dataModelConventions.html">General Conventions</a>
</li>
<li>
<a href="ehrObsPeriods.html">Observation Periods for EHR Data</a>
</li>
<li>
<a href="cdmPrivacy.html">Patient Privacy and OMOP</a>
</li>
</ul>
2019-10-31 19:06:09 +00:00
</li>
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-history"></span>
2019-10-31 19:06:09 +00:00
CDM Versions
<span class="caret"></span>
</a>
<ul class="dropdown-menu" role="menu">
<li>
<a href="cdm30.html">CDM v3.0</a>
</li>
2019-10-31 19:06:09 +00:00
<li>
<a href="cdm60.html">CDM v6.0</a>
2019-10-31 19:06:09 +00:00
</li>
<li>
<a href="cdm53.html">CDM v5.3</a>
</li>
<li class="dropdown-submenu">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">NEW CDM v5.4</a>
<ul class="dropdown-menu" role="menu">
<li>
<a href="cdm54.html">CDM v5.4</a>
</li>
<li>
<a href="cdm54Changes.html">Changes from CDM v5.3</a>
</li>
<li>
<a href="cdm54erd.html">Entity Relationships</a>
</li>
</ul>
2019-10-31 19:06:09 +00:00
</li>
</ul>
</li>
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-plus-square"></span>
2019-10-31 19:06:09 +00:00
2022-07-27 01:48:28 +00:00
CDM Proposals
2019-10-31 19:06:09 +00:00
<span class="caret"></span>
</a>
<ul class="dropdown-menu" role="menu">
2022-07-27 01:48:28 +00:00
<li>
<a href="cdmRequestProcess.html">How to Propose Changes to the CDM</a>
</li>
2019-10-31 19:06:09 +00:00
<li>
<a href="https://github.com/OHDSI/CommonDataModel/issues?q=is%3Aopen+is%3Aissue+label%3AProposal">Under Review</a>
2019-10-31 19:06:09 +00:00
</li>
<li class="dropdown-submenu">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">Accepted</a>
2019-10-31 19:06:09 +00:00
<ul class="dropdown-menu" role="menu">
<li>
<a href="https://github.com/OHDSI/CommonDataModel/issues/252">Region_concept_id</a>
</li>
</ul>
</li>
</ul>
</li>
2020-10-06 15:11:13 +00:00
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-question"></span>
2019-10-31 19:06:09 +00:00
How to
2020-10-06 15:11:13 +00:00
<span class="caret"></span>
2019-10-31 19:06:09 +00:00
</a>
2020-10-06 15:11:13 +00:00
<ul class="dropdown-menu" role="menu">
<li>
<a href="download.html">Download the DDL</a>
2020-10-06 15:11:13 +00:00
</li>
<li>
<a href="cdmRPackage.html">Use the CDM R Package</a>
</li>
<li>
<a href="drug_dose.html">Calculate Drug Dose</a>
2020-10-06 15:11:13 +00:00
</li>
</ul>
2019-10-31 19:06:09 +00:00
</li>
<li class="dropdown">
2022-07-27 01:48:28 +00:00
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span class="fa fa-life-ring"></span>
2019-10-31 19:06:09 +00:00
Support
<span class="caret"></span>
2019-10-31 19:06:09 +00:00
</a>
<ul class="dropdown-menu" role="menu">
2022-07-27 01:48:28 +00:00
<li>
<a href="cdmDecisionTree.html">Help! My Data Doesn't Fit!</a>
</li>
<li>
<a href="faq.html">FAQ</a>
</li>
2020-10-06 15:11:13 +00:00
<li>
<a href="sqlScripts.html">SQL Scripts</a>
2020-10-06 15:11:13 +00:00
</li>
<li>
<a href="contribute.html">Ask a Question</a>
</li>
</ul>
2019-10-31 19:06:09 +00:00
</li>
</ul>
<ul class="nav navbar-nav navbar-right">
<li>
<a href="https://github.com/OHDSI/CommonDataModel">
<span class="fa fa-github"></span>
2019-10-31 19:06:09 +00:00
</a>
</li>
</ul>
</div><!--/.nav-collapse -->
</div><!--/.container -->
</div><!--/.navbar -->
<div id="header">
2019-10-31 19:06:09 +00:00
<h1 class="title toc-ignore"><img src="ohdsi40x40.png"></img> OMOP CDM
Background</h1>
2019-10-31 19:06:09 +00:00
</div>
<div id="background" class="section level2">
<h2>Background</h2>
<p>The Observational Medical Outcomes Partnership (OMOP) was a
public-private partnership established to inform the appropriate use of
observational healthcare databases for studying the effects of medical
products. Over the course of the 5-year project and through its
community of researchers from industry, government, and academia, OMOP
successfully achieved its aims to:</p>
2019-10-31 19:06:09 +00:00
<ul>
<li>Conduct methodological research to empirically evaluate the
performance of various analytical methods on their ability to identify
true associations and avoid false findings</li>
<li>Develop tools and capabilities for transforming, characterizing, and
analysing disparate data sources across the health care delivery
spectrum</li>
<li>Establish a shared resource so that the broader research community
can collaboratively advance the science</li>
2019-10-31 19:06:09 +00:00
</ul>
<p>The results of OMOPs research has been widely published and
presented at scientific conferences, including <a
href="https://www.ohdsi.org/2021-ohdsi-global-symposium-info/">annual
symposia</a>.</p>
2019-10-31 19:06:09 +00:00
<p>The OMOP Legacy continues…</p>
<p>The community is actively using the OMOP Common Data Model for their
various research purposes. Those tools will continue to be maintained
and supported, and information about this work is available in the <a
href="http://www.github.com/ohdsi">public domain</a>.</p>
<p>The OMOP Common Data Model will continue to be an open-source
community standard for observational healthcare data. The model
specifications and associated work products will be placed in the public
domain, and the entire research community is encouraged to use these
tools to support everybodys own research activities.</p>
2019-10-31 19:06:09 +00:00
</div>
<div id="the-role-of-the-common-data-model" class="section level2">
<h2>The Role of the Common Data Model</h2>
<p>No single observational data source provides a comprehensive view of
the clinical data a patient accumulates while receiving healthcare, and
therefore none can be sufficient to meet all expected outcome analysis
needs. This explains the need for assessing and analyzing multiple data
sources concurrently using a common data standard. This standard is
provided by the OMOP Common Data Model (CDM).</p>
<p>The CDM is designed to support the conduct of research to identify
and evaluate associations between interventions (drug exposure,
procedures, healthcare policy changes etc.) and outcomes caused by these
interventions (condition occurrences, procedures, drug exposure etc.).
Outcomes can be efficacious (benefit) or adverse (safety risk). Often
times, specific patient cohorts (e.g., those taking a certain drug or
suffering from a certain disease) may be defined for treatments or
outcomes, using clinical events (diagnoses, observations, procedures,
etc.) that occur in predefined temporal relationships to each other. The
CDM, combined with its standardized content (via the Standardized
Vocabularies), will ensure that research methods can be systematically
applied to produce meaningfully comparable and reproducible results.</p>
2019-10-31 19:06:09 +00:00
</div>
<div id="design-principles" class="section level2">
<h2>Design Principles</h2>
<p>The CDM is designed to include all observational health data elements
(experiences of the patient receiving health care) that are relevant for
analytic use cases to support the generation of reliable scientific
evidence about disease natural history, healthcare delivery, effects of
medical interventions, the identification of demographic information,
health care interventions and outcomes.</p>
<p>Therefore, the CDM is designed to store observational data to allow
for research, under the following principles:</p>
2019-10-31 19:06:09 +00:00
<ul>
<li><strong>Suitability for purpose:</strong> The CDM aims to provide
data organized in a way optimal for analysis, rather than for the
purpose of addressing the operational needs of health care providers or
payers.</li>
<li><strong>Data protection:</strong> All data that might jeopardize the
identity and protection of patients, such as names, precise birthdays
etc. are limited. Exceptions are possible where the research expressly
requires more detailed information, such as precise birth dates for the
study of infants.</li>
<li><strong>Design of domains:</strong> The domains are modeled in a
person-centric relational data model, where for each record the identity
of the person and a date is captured as a minimum.</li>
<li><strong>Rationale for domains:</strong> Domains are identified and
separately defined in an entity-relationship model if they have an
analysis use case and the domain has specific attributes that are not
otherwise applicable. All other data can be preserved as an observation
in an entity-attribute-value structure.</li>
<li><strong>Standardized Vocabularies:</strong> To standardize the
content of those records, the CDM relies on the Standardized
Vocabularies containing all necessary and appropriate corresponding
standard healthcare concepts.</li>
<li><strong>Reuse of existing vocabularies:</strong> If possible, these
concepts are leveraged from national or industry standardization or
vocabulary definition organizations or initiatives, such as the National
Library of Medicine, the Department of Veterans Affairs, the Center of
Disease Control and Prevention, etc.</li>
<li><strong>Maintaining source codes:</strong> Even though all codes are
mapped to the Standardized Vocabularies, the model also stores the
original source code to ensure no information is lost.</li>
<li><strong>Technology neutrality:</strong> The CDM does not require a
specific technology. It can be realized in any relational database, such
as Oracle, SQL Server etc., or as SAS analytical datasets.</li>
<li><strong>Scalability:</strong> The CDM is optimized for data
processing and computational analysis to accommodate data sources that
vary in size, including databases with up to hundreds of millions of
persons and billions of clinical observations.</li>
<li><strong>Backwards compatibility:</strong> All changes from previous
CDMs are clearly delineated in the <a
href="https://github.com/OHDSI/CommonDataModel">github repository</a>.
Older versions of the CDM can be easily created from the CDMv5, and no
information is lost that was present previously.</li>
2019-10-31 19:06:09 +00:00
</ul>
</div>
</div>
</div>
</div>
<script>
// add bootstrap table styles to pandoc tables
function bootstrapStylePandocTables() {
2021-01-06 15:52:57 +00:00
$('tr.odd').parent('tbody').parent('table').addClass('table table-condensed');
2019-10-31 19:06:09 +00:00
}
$(document).ready(function () {
bootstrapStylePandocTables();
});
</script>
<!-- tabsets -->
<script>
$(document).ready(function () {
window.buildTabsets("TOC");
});
$(document).ready(function () {
$('.tabset-dropdown > .nav-tabs > li').click(function () {
$(this).parent().toggleClass('nav-tabs-open');
});
});
</script>
<!-- code folding -->
<script>
$(document).ready(function () {
// temporarily add toc-ignore selector to headers for the consistency with Pandoc
$('.unlisted.unnumbered').addClass('toc-ignore')
// move toc-ignore selectors from section div to header
$('div.section.toc-ignore')
.removeClass('toc-ignore')
.children('h1,h2,h3,h4,h5').addClass('toc-ignore');
// establish options
var options = {
selectors: "h1,h2,h3",
theme: "bootstrap3",
context: '.toc-content',
hashGenerator: function (text) {
2021-01-06 15:52:57 +00:00
return text.replace(/[.\\/?&!#<>]/g, '').replace(/\s/g, '_');
},
ignoreSelector: ".toc-ignore",
scrollTo: 0
};
options.showAndHide = true;
options.smoothScroll = true;
// tocify
var toc = $("#TOC").tocify(options).data("toc-tocify");
});
</script>
2019-10-31 19:06:09 +00:00
<!-- dynamically load mathjax for compatibility with self-contained -->
<script>
(function () {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://mathjax.rstudio.com/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML";
document.getElementsByTagName("head")[0].appendChild(script);
})();
</script>
</body>
</html>