Merge pull request #187 from adambouras/master

106: Resolving observation_period_end_date without exact information on a last day PR

docs/_data/sidebars/mydoc_sidebar.yml

@@ -138,9 +138,9 @@ entries:
     #   url: /observation.html
     #   output: web, pdf
 
-    # - title: Observation Period
-    #   url: /observation_period.html
-    #   output: web, pdf
+    - title: Observation Period
+      url: /observation_period.html
+      output: web, pdf
 
     # - title: Payer Plan Period
     #   url: /payer_plan_period.html
@@ -230,6 +230,9 @@ entries:
       - title: Year of Birth
         url: /tag_year_of_birth.html
         output: web
+      - title: Observation Period
+        url: /tag_observation_period.html
+        output: web
 
 
 

docs/_data/tags.yml

@@ -23,4 +23,6 @@ allowed-tags:
   - datetime
   - patient_reported
   - observation_period
+  - event 
+  - survival
 # Copyright 2021 Google LLC

docs/pages/general_conventions/events_with_no_exact_last_day.md

@@ -0,0 +1,46 @@
+---
+title: Resolving Observation Period End Date without Exact Information on a Last Day
+keywords: observation_period, event, survival
+last_updated: April 30, 2024
+tags: [observation_period, event, survival]
+summary: "Resolving observation period end date without exact information on a last day"
+sidebar: mydoc_sidebar
+permalink: /events_with_no_exact_last_day.html
+---
+
+## Issue # and location
+[Themis Issue #106](https://github.com/OHDSI/Themis/issues/106)
+
+## Issue Summary
+Resolving `observation_period_end_date` without exact information on a last day
+
+## Convention type
+Table 
+
+## CDM table
+`OBSERVATION_PERIOD`
+
+## CDM field
+`observation_period_end_date`
+
+## Links to issue discussion
+- [OHDSI Forums discussion](https://forums.ohdsi.org/t/resolving-observation-period-end-date-without-exact-information-on-a-last-day/13048)
+- [CDM Documentation](https://ohdsi.github.io/CommonDataModel/cdm54.html#observation_period)
+
+## Provenance of data
+General
+
+## The ratified convention
+It is often the case that the idea of Observation Periods does not exist in source data. In those cases, the `observation_period_end_date` can be inferred as the last event date available for the person.
+
+## Date of ratification/published
+NA
+
+## Downstream implications
+This convention can lead to a bias in survival studies. Namely, healthy persons will have shorter observation periods and not contributing to survival time as much.
+
+## Link to DQD check
+No
+
+## Related conventions/further information
+NA

docs/pages/observation_period/observation_period.md

@@ -0,0 +1,16 @@
+---
+title: OBSERVATION_PERIOD
+keywords: observation_period, observation_end_date
+last_updated: May 04, 2024
+tags: [observation_period, event, survival]
+summary: "Conventions related to mapping data into the OBSERVATION_PERIOD table."
+sidebar: mydoc_sidebar
+permalink: /observation_period.html
+---
+
+## Field-level Conventions
+
+| **Field** | **Convention** |
+|:--------|:-------|
+|  OBSERVATION_PERIOD_END_DATE  |  [Resolving Observation Period End Date without Exact Information on a Last Day](events_with_no_exact_last_day.html)  |
+|=====