Skip to content

Commit 9c39ccb

Browse files
committed
Incorporate remaining Andrew edits
1 parent 185b04d commit 9c39ccb

File tree

4 files changed

+104
-36
lines changed

4 files changed

+104
-36
lines changed

docs/images/ohdsi_gis_overview.png

278 KB
Loading

docs/index.html

Lines changed: 68 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -408,26 +408,50 @@ <h1 class="title toc-ignore"><img src="ohdsi40x40.png"></img> OHDSI GIS
408408
</div>
409409

410410

411-
<div id="ohdsi-geographic-informations-systems-gis-workgroup-homepage"
411+
<div id="ohdsi-geographic-informations-systems-gis"
412412
class="section level1">
413-
<h1><strong>OHDSI Geographic Informations Systems (GIS) Workgroup
414-
Homepage</strong></h1>
413+
<h1><strong>OHDSI Geographic Informations Systems (GIS)</strong></h1>
414+
<p><br></p>
415415
<div id="mission" class="section level2">
416416
<h2><strong>Mission</strong></h2>
417417
<p>Improve the health of populations by generating reliable evidence
418418
from integrated geospatial and person-level health data.</p>
419+
<p><br></p>
419420
</div>
420-
<div id="meeting-schedule" class="section level2">
421-
<h2><strong>Meeting Schedule</strong></h2>
422-
<p>The OHDSI GIS Workgroup meets weekly on <strong>Fridays at 10 AM
423-
ET</strong> (<a
421+
<div id="collaboration-approach" class="section level2">
422+
<h2><strong>Collaboration Approach</strong></h2>
423+
<p>Like most of OHDSI, we use Github and MS Teams for collaboration,
424+
version control, etc. There are no perfect options for supporting
425+
collaboration. We’ll help you accomodate to ours as best we can. In
426+
particular, we use Github for managing tasks like defining and
427+
monitoring progress on OHDSI studies, infrastructure roadmaps, technical
428+
issues, etc.</p>
429+
<p>We review progress and get input from the broader group at weekly
430+
meetings on Fridays. Leaders of specific projects within the GIS
431+
workgroup schedule and hold meetings with subgroups outside the main
432+
Friday meeting. Those other meetings are where most of the work on use
433+
cases and advancing technical infrastructure gets done.</p>
434+
<p>Apart from the groups’ offical leadership, many members make
435+
fundamental contributions to the group’s decisions, strategies, and
436+
products.</p>
437+
<p>All are welcome. We’d love to work with you. Please see our page on
438+
<a href="getting-involved.html#Proposing_a_new_Use_Case">proposing new
439+
use cases</a>. If you are new and are considering using the GIS
440+
toolchain to do research or contibuting to the group’s work, we will
441+
schedule a separate meeting with you to help you figure out what manner
442+
of participation makes sense for you.</p>
443+
<p>New to OHDSI? First sign up for an OHDSI MS Teams account <a
444+
href="https://forms.office.com/Pages/ResponsePage.aspx?id=lAAPoyCRq0q6TOVQkCOy1ZyG6Ud_r2tKuS0HcGnqiQZUQ05MOU9BSzEwOThZVjNQVVFGTDNZRENONiQlQCN0PWcu">here</a>.
445+
It’s easy peasy. Already have an OHDSI Teams account? Great. Just sign
446+
up for the GIS Workgroup <a
447+
href="https://forms.office.com/Pages/ResponsePage.aspx?id=lAAPoyCRq0q6TOVQkCOy1ZyG6Ud_r2tKuS0HcGnqiQZUOVJFUzBFWE1aSVlLN0ozR01MUVQ4T0RGNyQlQCN0PWcu">here</a>.</p>
448+
<p>The main workgroup call is on MS Teams every Friday at 10 AM US
449+
Eastern Time (<a
424450
href="https://teams.microsoft.com/l/meetup-join/19%3af4d776830f504bf3827fe4309156a3c6%40thread.tacv2/1724707871947?context=%7b%22Tid%22%3a%22a30f0094-9120-4aab-ba4c-e5509023b2d5%22%2c%22Oid%22%3a%22457ee911-94c1-4da2-8287-8d8a5a749931%22%7d">Meeting
425-
Link</a>)</p>
426-
<p>We also meet out-of-band with collaborators at “use case” meetings.
427-
If you have specific goals for generating evidence using place-based
428-
data in conjunction with OMOP data, we’d love to work with you. Please
429-
see our page on <a href="gi-propose-usecase.html">proposing new use
430-
cases</a>. <br></p>
451+
Link</a>). We are always looking for better ways to accomodate the time
452+
constraints of valued members around the world. Please let us know if
453+
this schedule is an obstacle.</p>
454+
<p><br></p>
431455
</div>
432456
<div id="gis-toolchain" class="section level2">
433457
<h2><strong>GIS Toolchain</strong></h2>
@@ -445,8 +469,8 @@ <h2><strong>GIS Toolchain</strong></h2>
445469
catalogs of available data sources.</p>
446470
<p>Importantly, the toolchain allows integrated analysis of geospatial
447471
and EHR data without sharing any sensitive patient location data.</p>
448-
<div id="omop-gis-schema-extensions" class="section level3">
449-
<h3>OMOP GIS schema extensions</h3>
472+
<div id="omop-gis-schema-extensions" class="section level4">
473+
<h4><strong>OMOP GIS schema extensions</strong></h4>
450474
<p>The External_Exposure table is an extension to the main OMOP schema.
451475
It holds data on things that can affect health that are associated with
452476
the places where patients live. The Location_History table contains
@@ -459,8 +483,8 @@ <h3>OMOP GIS schema extensions</h3>
459483
and the main OMOP schema is <a
460484
href="schema-extensions.html#OMOP_GIS_Schema_Extensions">here</a>.</p>
461485
</div>
462-
<div id="omop-vocabulary-extensions" class="section level3">
463-
<h3>OMOP Vocabulary extensions</h3>
486+
<div id="omop-vocabulary-extensions" class="section level4">
487+
<h4><strong>OMOP Vocabulary extensions</strong></h4>
464488
<p>The GIS extensions to the OMOP Vocabulary cover geometries,
465489
toxicants, and social determinants. They are used to represent a very
466490
large set of entities that can affect health and their relationships.
@@ -474,8 +498,8 @@ <h3>OMOP Vocabulary extensions</h3>
474498
versioned community-maintained extensions of the core OMOP
475499
Vocabulary.</p>
476500
</div>
477-
<div id="gaiacore" class="section level3">
478-
<h3>gaiaCore</h3>
501+
<div id="gaiacore" class="section level4">
502+
<h4><strong>gaiaCore</strong></h4>
479503
<p>The gaiaCore software and associated gaiaDB schema support
480504
specification of attributes and geographic shapes in publicly available
481505
datasets. This specification allows the tables in the GIS schema
@@ -484,8 +508,8 @@ <h3>gaiaCore</h3>
484508
documentation are <a
485509
href="https://github.com/OHDSI/gaiaCore">here</a>.</p>
486510
</div>
487-
<div id="guidance" class="section level3">
488-
<h3>Guidance</h3>
511+
<div id="guidance" class="section level4">
512+
<h4><strong>Guidance</strong></h4>
489513
<p>The GIS toolchain requires patient addresses to be geocoded into
490514
representations that GIS software expects; for example, the latitude and
491515
longitude coordinates of street addresses or the coordinates of the
@@ -499,8 +523,9 @@ <h3>Guidance</h3>
499523
to addressing a research question.</p>
500524
</div>
501525
<div id="support-for-integration-with-ohdsis-technical-ecosytem"
502-
class="section level3">
503-
<h3>Support for integration with OHDSI’s technical ecosytem</h3>
526+
class="section level4">
527+
<h4><strong>Support for integration with OHDSI’s technical
528+
ecosytem</strong></h4>
504529
<p>The GIS Workgroup provides modified versions of the BroadSea
505530
container that inlcudes versions of the OHDSI Vocabulary that include
506531
draft the GIS vocabularies and the other components of the toolchain.
@@ -512,6 +537,20 @@ <h3>Support for integration with OHDSI’s technical ecosytem</h3>
512537
schema.org-compliant standards and federated metadata sharing methods
513538
widely used in the GIS community to share information about available
514539
datasets.</p>
540+
<p><br></p>
541+
<p><img src="images/ohdsi_gis_overview.png" style="width:150.0%" /></p>
542+
<p>The green and black elements at the top of the figure above show the
543+
production of reliable evidence by applying standardized analytics to
544+
standardized person-level clinical data. The extension of this approach
545+
by the GIS toolchain is shown below that. Geocoded patient addresses are
546+
linked to geospatial datasets and standardized in the OMOP GIS
547+
extension. The GIS toolchain uses the same modeling approach as the main
548+
OMOP CDM and vocabulary. This allows the same best practice analytics to
549+
be applied simultaneously to both person-level clinical data and
550+
geospatial data on exposures outside the clinic. As with OHDSI’s use of
551+
clinical data, analyses of external exposures are done without sharing
552+
patient address information.</p>
553+
<p><br></p>
515554
</div>
516555
</div>
517556
<div id="goals" class="section level2">
@@ -523,6 +562,7 @@ <h2><strong>Goals</strong></h2>
523562
supported privacy-protecting geocoding software - Develop data
524563
cataloging resources and guidance that enable reuse of specific
525564
geospatial datasets in OHDSI studies</p>
565+
<p><br></p>
526566
</div>
527567
<div id="roadmaps" class="section level2">
528568
<h2><strong>Roadmaps</strong></h2>
@@ -534,9 +574,10 @@ <h2><strong>Roadmaps</strong></h2>
534574
<li><a
535575
href="https://github.com/OHDSI/GIS/issues/369">Vocabulary</a></li>
536576
</ul>
577+
<p><br></p>
537578
</div>
538-
<div id="publicationspresentation" class="section level2">
539-
<h2><strong>Publications/Presentation</strong></h2>
579+
<div id="publicationspresentations" class="section level2">
580+
<h2><strong>Publications/Presentations</strong></h2>
540581
<p>OHDSI GIS Toolchain Live Demonstration (2024 OHDSI Symposium <a
541582
href="https://www.youtube.com/watch?v=NLfWvuZJVK4">Video</a>)</p>
542583
<p>OHDSI GIS Infrastructure (2023 OHDSI Symposium <a
@@ -552,7 +593,8 @@ <h2><strong>Publications/Presentation</strong></h2>
552593
<a
553594
href="https://www.ohdsi.org/wp-content/uploads/2023/02/GIS-OKRs2023Q1.pdf">slides</a>)</p>
554595
<p>OHDSI GIS Workgroup August 23, 2022 Update (<a
555-
href="https://youtu.be/d8jIAm9cssM">Video</a>) <br></p>
596+
href="https://youtu.be/d8jIAm9cssM">Video</a>)</p>
597+
<p><br></p>
556598
</div>
557599
</div>
558600

rmd/images/ohdsi_gis_overview.png

278 KB
Loading

rmd/index.Rmd

Lines changed: 36 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,31 @@ output:
88
collapsed: false
99
---
1010

11-
# **OHDSI Geographic Informations Systems (GIS) Workgroup Homepage**
11+
# **OHDSI Geographic Informations Systems (GIS)**
12+
13+
<br>
1214

1315
## **Mission**
1416

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

17-
## **Meeting Schedule**
19+
<br>
20+
21+
## **Collaboration Approach**
22+
23+
Like most of OHDSI, we use Github and MS Teams for collaboration, version control, etc. There are no perfect options for supporting collaboration. We'll help you accomodate to ours as best we can. In particular, we use Github for managing tasks like defining and monitoring progress on OHDSI studies, infrastructure roadmaps, technical issues, etc.
1824

19-
The OHDSI GIS Workgroup meets weekly on **Fridays at 10 AM ET** ([Meeting Link](https://teams.microsoft.com/l/meetup-join/19%3af4d776830f504bf3827fe4309156a3c6%40thread.tacv2/1724707871947?context=%7b%22Tid%22%3a%22a30f0094-9120-4aab-ba4c-e5509023b2d5%22%2c%22Oid%22%3a%22457ee911-94c1-4da2-8287-8d8a5a749931%22%7d))
25+
We review progress and get input from the broader group at weekly meetings on Fridays. Leaders of specific projects within the GIS workgroup schedule and hold meetings with subgroups outside the main Friday meeting. Those other meetings are where most of the work on use cases and advancing technical infrastructure gets done.
26+
27+
Apart from the groups' offical leadership, many members make fundamental contributions to the group's decisions, strategies, and products.
28+
29+
All are welcome. We'd love to work with you. Please see our page on [proposing new use cases](getting-involved.html#Proposing_a_new_Use_Case). If you are new and are considering using the GIS toolchain to do research or contibuting to the group's work, we will schedule a separate meeting with you to help you figure out what manner of participation makes sense for you.
30+
31+
New to OHDSI? First sign up for an OHDSI MS Teams account [here](https://forms.office.com/Pages/ResponsePage.aspx?id=lAAPoyCRq0q6TOVQkCOy1ZyG6Ud_r2tKuS0HcGnqiQZUQ05MOU9BSzEwOThZVjNQVVFGTDNZRENONiQlQCN0PWcu). It's easy peasy.
32+
Already have an OHDSI Teams account? Great. Just sign up for the GIS Workgroup [here](https://forms.office.com/Pages/ResponsePage.aspx?id=lAAPoyCRq0q6TOVQkCOy1ZyG6Ud_r2tKuS0HcGnqiQZUOVJFUzBFWE1aSVlLN0ozR01MUVQ4T0RGNyQlQCN0PWcu).
33+
34+
The main workgroup call is on MS Teams every Friday at 10 AM US Eastern Time ([Meeting Link](https://teams.microsoft.com/l/meetup-join/19%3af4d776830f504bf3827fe4309156a3c6%40thread.tacv2/1724707871947?context=%7b%22Tid%22%3a%22a30f0094-9120-4aab-ba4c-e5509023b2d5%22%2c%22Oid%22%3a%22457ee911-94c1-4da2-8287-8d8a5a749931%22%7d)). We are always looking for better ways to accomodate the time constraints of valued members around the world. Please let us know if this schedule is an obstacle.
2035

21-
We also meet out-of-band with collaborators at "use case" meetings. If you have specific goals for generating evidence using place-based data in conjunction with OMOP data, we’d love to work with you. Please see our page on [proposing new use cases](gi-propose-usecase.html).
2236
<br>
2337

2438
## **GIS Toolchain**
@@ -27,22 +41,29 @@ The GIS toolchain consists of extensions to the OMOP schema, extensions to the O
2741

2842
Importantly, the toolchain allows integrated analysis of geospatial and EHR data without sharing any sensitive patient location data.
2943

30-
### OMOP GIS schema extensions
44+
#### **OMOP GIS schema extensions**
3145
The External_Exposure table is an extension to the main OMOP schema. It holds data on things that can affect health that are associated with the places where patients live. The Location_History table contains information on patient's residence and the dates during which they lived in that location. The DDLs and associated documentation for the External_Exposure table and the Location_History table are [here](schema-extensions.html#location_history) and [here](schema-extensions.html#external_exposure) respectively. The entity-relationship diagram showing the joins between these tables and the main OMOP schema is [here](schema-extensions.html#OMOP_GIS_Schema_Extensions).
3246

33-
### OMOP Vocabulary extensions
47+
#### **OMOP Vocabulary extensions**
3448
The GIS extensions to the OMOP Vocabulary cover geometries, toxicants, and social determinants. They are used to represent a very large set of entities that can affect health and their relationships. The draft versions of these vocabularies are available [here](https://github.com/OHDSI/GIS/tree/main/vocabularies). They are based on mature existing ontologies and were developed by GIS workgroup members who are part of the OHDSI Core Vocabulary team in accordance with the guiding principles for OMOP vocabulary development, quality assurance, and integration. Current work on their validation in real use cases is expected to support their eventual acceptance as versioned community-maintained extensions of the core OMOP Vocabulary.
3549

36-
### gaiaCore
50+
#### **gaiaCore**
3751
The gaiaCore software and associated gaiaDB schema support specification of attributes and geographic shapes in publicly available datasets. This specification allows the tables in the GIS schema extension to be joined with patient-level clinical data stored in the main OMOP schema. The current Beta release of gaiaCore software and its documentation are [here](https://github.com/OHDSI/gaiaCore).
3852

39-
### Guidance
53+
#### **Guidance**
4054
The GIS toolchain requires patient addresses to be geocoded into representations that GIS software expects; for example, the latitude and longitude coordinates of street addresses or the coordinates of the lines that define a postal region. The OHDSI GIS workgroup does not provide or maintain software that does this geocoding. The GIS Workgroup does provide guidance about privacy-preserving options for geocoding address information and considerations for using available open-source and comercial geocoding approaches. The workgroup is also developing guidance to aid researchers in making informed decisions about selecting and working with alternative geospatial data sources that are relevant to addressing a research question.
4155

42-
### Support for integration with OHDSI's technical ecosytem
56+
#### **Support for integration with OHDSI's technical ecosytem**
4357
The GIS Workgroup provides modified versions of the BroadSea container that inlcudes versions of the OHDSI Vocabulary that include draft the GIS vocabularies and the other components of the toolchain. Modified versions of the Tufts Synthetic Data and associated for demonstrating the use of the HADES PLP package to predict incident respiratory conditions using regional air quality data are included in the container.
4458
The workgroup is developing a robust approach to working with available geospatial data sources via catalogs. The approach uses schema.org-compliant standards and federated metadata sharing methods widely used in the GIS community to share information about available datasets.
4559

60+
<br>
61+
62+
![](images/ohdsi_gis_overview.png){width=150%}
63+
64+
The green and black elements at the top of the figure above show the production of reliable evidence by applying standardized analytics to standardized person-level clinical data. The extension of this approach by the GIS toolchain is shown below that. Geocoded patient addresses are linked to geospatial datasets and standardized in the OMOP GIS extension. The GIS toolchain uses the same modeling approach as the main OMOP CDM and vocabulary. This allows the same best practice analytics to be applied simultaneously to both person-level clinical data and geospatial data on exposures outside the clinic. As with OHDSI's use of clinical data, analyses of external exposures are done without sharing patient address information.
65+
66+
<br>
4667

4768
## **Goals**
4869

@@ -53,14 +74,18 @@ The OHDSI GIS Workgroup carries out work in support of its mission by pursuing t
5374
- Facilitate the use of externally supported privacy-protecting geocoding software
5475
- Develop data cataloging resources and guidance that enable reuse of specific geospatial datasets in OHDSI studies
5576

77+
<br>
78+
5679
## **Roadmaps**
5780

5881
- [Gaia](https://github.com/OHDSI/GIS/issues/368)
5982
- [Gaia Catalog](https://github.com/OHDSI/GIS/issues/365)
6083
- [Geocoding](https://github.com/OHDSI/GIS/issues/366)
6184
- [Vocabulary](https://github.com/OHDSI/GIS/issues/369)
6285

63-
## **Publications/Presentation**
86+
<br>
87+
88+
## **Publications/Presentations**
6489
OHDSI GIS Toolchain Live Demonstration (2024 OHDSI Symposium [Video](https://www.youtube.com/watch?v=NLfWvuZJVK4))
6590

6691
OHDSI GIS Infrastructure (2023 OHDSI Symposium [Poster](https://www.ohdsi.org/2023showcase-19/), [Abstract](https://www.ohdsi.org/wp-content/uploads/2023/10/19-zollovenecek-BriefReport.pdf))
@@ -72,5 +97,6 @@ OHDSI GIS Workgroup October 10, 2023 Update ([Video](https://youtu.be/QZY-slWdsM
7297
OHDSI GIS Workgroup 2023 Objectives and Key Results ([Video](https://www.youtube.com/watch?v=bd0htzO1hx4&t=1103s), [slides](https://www.ohdsi.org/wp-content/uploads/2023/02/GIS-OKRs2023Q1.pdf))
7398

7499
OHDSI GIS Workgroup August 23, 2022 Update ([Video](https://youtu.be/d8jIAm9cssM))
100+
75101
<br>
76102

0 commit comments

Comments
 (0)